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SUMMARY  OF  THE  TAXQNCMIC  WORKSTATION  SYSTEM 


INTRODUCTION 


TWS  FEATURE 
SUMMARY 


The  Taxoncmic  Workstation  System  (TWS)  is  a 
PC-based,  menu-driven  relational  data  base 
used  for  creation  and  manipulation  of 
taxonomies  (or  anything  in  a  list  structure) . 
The  data  base  is  delivered  with  14  taxonomies 
accessed  from  16  system  menus.  The  software 
allows  the  user  to  edit  taxonomy  components, 
to  modify  existing  taxonomies,  to  create 
taxonomies  using  provided  templates  and  to 
create  customized  applications  using  a  generic 
program. 

This  User  Guide  provides  information  and 
directions  far  using  the  TWS  software.  The 
manual  assumes  that  you,  the  user,  have  a 
working  knowledge  of  the  computer  you  use, 
MS-DOS,  and  ary  external  programs  or  files 
that  you  may  call  from  TWS.  You  must  have 
ADVANCED  REVELATION  (AKEV)  to  install  TWS 
(see  the  section  on  Hardware  and  Software 
Requirements) . 

The  TWS  operates  on  personal  computers  and  has 
these  features: 

(1)  User  friendly  operating  system  with 
menus,  windows  and  help  screens. 

(2)  Library  of  taxonomies,  including  military 
operations  and  command  and  control 
listings,  battlefield  conditions 
taxonomy,  TRADOC's  Blueprint  of  the 
Battlefield,  and  ability  (cognitive, 
sensory,  psydhcmotar)  taxonomies. 

(3)  Edit,  merge  and  modify  functions  for 
taxonomies  in  the  TWS  Library. 

(4)  Create,  edit,  merge,  and  modify  functions 
for  new  taxonomies. 

(5)  Query  retrieval  capability  to  search  on 
designated  terms. 

(6)  Linkage  of  task  and  ability  taxonomies. 

(7)  Export,  impart  features  which  allow  for 
easy  archiving  and  access  to  data. 

(8)  Report  generation. 

(9)  Detailed  User  Guide,  and  Quick  Reference 
Guide. 

(10)  A  structural  system  which  allows  4 
hierarchical  levels. 


o  The  Power  of 
a  Relational 
Data  Base 


o  Creating 
Taxonomies 


o  TWS  library 


TVS  Summary 

The  tvjs  operates  within  the  environment  of  the 
database  management  system  Advanced 
Revelation.  The  power  of  this  programmable 
relational  data  base  is  available  through  the 
developed  applications  package  which 
collectively  is  the  TWS.  A  summary  of  the 
features  of  tins  kind  of  data  base  is 
contained  in  Appendix  A. 

TWS  provides  you  with  the  capability  to  build 
taxonomies  using  a  set  of  templates  or  a  tool 
called  the  Generic  Feature.  Additionally, 
taxonomies  can  be  created  off  line  and 
imported  to  TWS.  A  separate  chapter  is 
devoted  to  demonstrating  how  to  enter  new 
taxonomies. 

Fourteen  taxonomies  are  contained  in  the  TWS 
Library.  They  are: 

-  Core  Army  Task  Analysis 

-  Field  Test  Task  Analysis 

-  Blueprint  of  the  Battlefield 

-  Conditions 

-  Protective  Ensemble  Task  Degradation 

-  Failure  Modes  and  Effects 

-  CMF-M3S  Listings 

-  Verb  Functions 

-  Standard  Task  Analysis  Parameters 

-  Ability  Taxonomies 

—  Cognitive  Abilities 
—  Cognitive  Repertories 
—  Cognitive  Constructs 
—  Skills 
—  Skill  Clusters 

The  TWS  data  base  is  designed  for  flexible 
user-specific  task  analysis.  It  incorporates 
task  descriptions  and  requirements  factors, 
and  personnel  demands  in  terms  of  knowledge, 
skills,  and  abilities.  These  factors  are 
contained  in  the  14  taxonomies  delivered  with 
the  data  base.  Two  taxonomies  define  the 
conditions  and  functions  concerning  missions; 
one  defines  parameters  affecting  tasks;  two 
provide  methods  to  classify  each  task;  and, 
seven  provide  ways  to  link  personnel 
to  task  analysis.  A  description  of  the 
modules  in  the  Library  is  provided  in  Table  1. 

Material  from  each  taxonomy  file  can  be 
collected  in  varying  configurations  to  build  a 
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Description  of  Modules  in  TWS  Library 
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subtasks  can  be  linked  with  the  Cognitive 
Abilities,  Cognitive  Reportories,  and  Cognitive 
Construct  taxonomies. 
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Jobs  option  (see  Chapter  on  Working  with  Lists).  ings  can  be  obtained  by  writing: 

The  CMF  items  can  be  collected  when  you  are  Commander,  US  Army  Soldier  Support 

detailing  Jobs  for  an  analysis.  Center  —  NCR,  ATTN:  ATNC-MOS-A,  200 

Stovall  St.,  Alexandria,  VA  22332) 


Verb  The  verb  functions  taxonomy  provides  a  method 
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range  values  for  the  task.  Replace  Resistor  1.9  1. 5-2.4 
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Each  ability  was  scored  as  being  either  re-  10  (NMF  Number  Facility) 

qulred  (1)  or  not  required  (0)  for  each  sub-  11  (DDR  Deductive  Reasoning) 

task.  The  results  are  shown  In  the  abilities  12  (1NR  Inductive  Reasoning) 

records.  13  (1N0  Information  Ordering) 

IS  (SOC  Speed  of  Closure) 
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organisation.  These  values  are  summed  for 
each  mission,  and  a  grand  total  is  given  for 
all  of  the  branch  missions. 
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■lsslon.  These  validated  values  are  shown  In  A19  Reaction  Time 

tables  In  the  skills  records.  Each  subtask  A21  Finger  Dexterity 
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vlth  the  TVS  Library  Modules. "  Definitions  of  many  of  the  items  in  these  taxonomies  can  be  obtained  by  the 
menu  selections  VIEW/ STRUCTURE/SYNONYMS. 


o  Other 

Capabilities 


TAXQNCMY  DESIGN 


specific  analysis.  You  are  able  to  edit, 
update,  enter,  and  display  records. 

Other  System  functions  include  file  and  print 
capabilities,  the  translation  of  data  far 
inpart  and  export  ocramnication ,  and  the 
ability  to  vise  external  applications  programs 
without  logging  off  the  TWS. 

Although  the  enphasis  of  the  1WS  is  an 
military  taxonomies  and  applications,  some  of 
the  taxonomies  and  indeed  the  taxonomy  tools 
(see  the  Chapters  on  working  with,  and 
creating  taxonomies)  can  be  used  far  a  myriad 
of  applications. 

TW5  provides  a  core  structure  which  is  the 
framework  upon  which  you  build.  This  core 
framework  contains  missions,  tasks,  and 
subtasks.  Additionally,  every  task  analysis 
project  is  identified  by  a  unique 
organization  number,  called  the  GROK).  The 
OR GNO  is  the  basic  ID  far  the  missions,  tasks, 
and  subtasks  included  far  a  particular  set. 
This  concept  will  be  addressed  throughout  the 
manual. 


ORGANIZATION 
OF  THE  MANUAL 


The  manual  next  presents  hardware  and 
software  requirements  and  options,  and 
installation  instructions. 


Next  is  a  lock  at  the  general  procedures  for 
getting  around  in  TVS.  This  will  get  you 
started  and  show  you  hew  to  move  through  and 
select  items  from  the  menus.  Techniques  and 
special  keys  that  are  available  throughout  TWS 
are  presented. 

A  discussion  of  Main  Menu  Functions  oanprises 
the  remainder  of  the  manual.  The  key 
functions,  each  detailed  in  separate  chapers, 
are: 

(1)  Browsing  through  already  created 
taxonomies  (i.e. ,  the  IMS  Library,  and 
ary  taxonomies  that  you  create) , 

(2)  Working  with  the  Library  taxonomies 
(editing,  rearranging  items),  and 

(3)  Creating  your  own  taxonomies 
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NOTE  ON  TWO 
VERSIONS  OF 
TWS 


TVS  Surtanarv 


Non-DOD  users  will  be  supplied  a  version  of 
the  TWS  which  does  not  contain  nary  of  the 
military  taxonomies;  however,  the  full  power 
and  capability  far  browsing  through,  working 
with,  and  creating  taxonomies  is  retained. 

It  is  recxamiended  that  the  user  of  the  non-DOD 
version  go  to  the  chapter  "Entering  New 
Taxonomies"  as  soon  as  you  have  an 
understanding  of  TWS  capabilities  and  feel 
comfortable  with  its  operation.  After 
completing  the  "Organizational  Chart  Setup", 
go  to  the  section  "Using  the  Develop  Feature 
of  the  Main  Menu."  Then  complete  the 
instructions  in  the  section  "Building  Custom 
Taxonomies."  These  procedures  will  provide 
you  with  exanples  which  will  make  the  chapters 
on  Browsing  and  Working  with  TWS  Library 
Modules  easier  to  follow. 
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AND  SOFTWARE  REQUIREMENTS 


USER  SUPPLIED 
SYSTEM 


The  following  hardware  list  presents  the 
minimum  equipment  and  software  required  to 
operate  the  TWS  system 


Item  Needed 


Available  Selection 


MS-DOS  Computer 


Memory 

Floppy  disk  drive 


Hard  disk 


Monitor  and 
adapter 


An  IEM  Personal  Ocnputer,  XT,  AT,  PS/2  or 
compatible  ocnputer  with  hard  disk  drive. 

640K. 

One  drive  having  any  of  the  following  formats: 

a.  36QK  5.25  inch. 

b.  1.2Mb  5.25  inch. 

c.  72GK  3.5  inch. 

10Mb  hard  disk  drive  with  5Mb  available  space. 
This  size  requirement  can  be  reduced  by 
deleting  unwanted  TWS  Library  files  once  the 
system  is  loaded.  See  Appendix  B. 

80-column  monochrome  monitor  and  driver 
adapter. 


Printer  and  driver  Epson,  Diablo  or  HP-LaserJet  II  or  any 

compatible  printer  that  will  emulate  these 
machines.  Parallel  or  serial  driver  card 
that  is  ccnpatible  with  the  selected  printer. 

DOS  DOS  2.0  or  later  version  including  3.xx  and 

4. XX. 


ADVANCED 

REVEIATICN 


ADVANCED  REVELATION,  a  relational  data  base 
management  system  is  required  to  run  the  TWS. 
See  Appendix  C  for  further  information. 
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OFTICNAL  EQUUMEJ7T  The  following  brief  list  of  optional 

equipment  has  been  selected  to  give  the  user 
the  largest  performance  return  far  equipment 
investment 


Optional  Items 


Math  ooprooessor 


Memory 


Additional  disk 
drives 


Mem  tor  and 
Adapter 


Modem 

Input  devioes 


Available  Selection 


An  8087  (PC/XT)  or  80287  (PC/AT)  math 
coprocessor  will  speed  up  statistical 
processing.  If  the  user  plans  to  develop 
other  applications  with  the  system,  the 
coprocessor  is  recommended. 

380K  extended  memory,  system  maximum  enhanced 
memory.  Note:  extended  and  enhanced  memory 
may  be  configured  as  PAM  disk  using 
IBM-DOS  VDISK.SYS  or  managed  by  a  user 
supplied  disk  cache. 

System  may  be  expanded  to  six  total  drives 
(A:  through  E:)  operating  under  DOS  2.x. 

Using  the  extended  environment  available  under 
DOS  3.x,  the  user  may  configure  physical  and 
virtual  drives  A:  through  Z: .  TVS  was 
developed  on  a  system  using  a  40  Mb  drive 
configured  into  two  virtual  drives  of  32  and  8 
Mb. 

TVS  supports  Monochrome,  Hercules,  OGA,  EGA, 
EBGA,  and  VGA  monitors  and  cards.  TVS  was 
developed  on  a  system  using  a  multiple  synch 
monitor  and  enhanced  EGA  640  x  350  graphics 
adapter. 

300/1200/2400/9600  Baud  Modem. 

PC-Mouse,  Microsoft  Mouse  and  compatible  track 
ball  and  graphics  tablet  systems. 
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OPTIONAL  SOFTWARE 


The  Suspend  inode  feature  of  TVJS  makes  the 
internal  calling  of  applications  programs  a 
useful  way  to  increase  the  flexibility  of 
processing  and  efficiency  of  operation.  The 
program  is  configured  to  call  the  following 
user  supplied  software  applications  programs. 
See  section  "Access  to  Applications  Packages" 
in  the  chapter  "Working  with  TWS  Library 
Modules." 


Optional  Item 


Description 


FCPUJS 


Shareware  teleccxnnunications  software 


Staartoom  II 


Tteleccciruni  cations  software 


WORDSTAR 


word  processor 


WordPerfect 


Ward  processor 


SuperCalc 


Electronic  spreadsheet 


dBASE  II  or  III  Data  base  management  system 


Arity  Prolog 


AI  natural  language  conpiler 
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TWS  INSTALLATICN  GUIDE 


Distribution  Disks  The  distribution  disks  contain  all  of  the 

programs  and  data  files  needed  to  run  the  TWS 
system  using  the  ADVANCED  REVELATION  AREV.EXE 
program  that  you  must  supply  (see  Appendix  C 
far  information  on  this  data  base  management 
system) . 

TWS  installation  Installing  the  TWS  software  is  a  sinple 

takes  20  minutes  process  that  takes  about  20  minutes  from 

start  to  finish.  You  may  stop  the 
installation  program  at  any  time,  if  it  is 
really  necessary,  but  you  will  have  to  repeat 
the  steps  that  were  done  prior  to  quitting. 

Hard  Disk  Space  Approximately  6  MB  of  disk  space  is  required 

for  TWS.  Make  sure  that  your  hard  disk  has 
adequate  space  far  the  TWS  program  files. 

Floppy  Disks  All  you  need  to  install  TWS  are  the  TWS 

System  Disks  and  the  ADVANCED  REVELATION 
INSTALLATION  DISK  that  came  with  your  copy  of 
Advanced  Revelation.  If  you  have  not  backed 
up  these  disks,  do  so  before  proceeding. 

TWS  Directory  An  AREV  subdirectory  is  created  off  the  root 

directory  as  follows: 

Root  directory 

\ 

—AREV 

\ 

I — Indexing 
I —TWS 


Installing  the  Place  Disk  Number  l  of  the  TWS  file  set  into 
TWS  Files  drive  A.  From  the  A  drive,  initiate  the 

loading  program  by  typing 

INSTALL 

To  select  the  directory  path  listed  on  the 
screen,  press  {Return};  otherwise  type  in 
the  desired  path.  Installation  will  begin, 
and  you  will  be  prcnpted  for  insertion  of 
each  TWS  diskette. 


Installing 

ADVANCED 

REVELATION 


Read  the  copy 
oanmand  carefully 


Running  TWS 


Finally,  place  the  bade  up  copy  of  the 
ADVANCED  REVELATION  INSTALLATION  DISK  in  disk 
drive  A.  copy  the  file  named  AREV  to  the 
AREV  subdirectory  using  this  statement; 

copy  A: AREV  \AREV\AREV.EXE 

The  AREV  file  an  the  ADVANCED  REVELATION 
INSTALLATION  DISK  has  NO  extension;  you  MUST 
add  the  .EXE  as  shown  in  the  example. 

Log  on  and  off  procedures,  and  general 
instructions  far  getting  around  in  the  INS  are 
provided  in  the  next  section  (BASIC 
OPERATIONAL  PROCEDURES) . 


Color  Monitor 
Setup 


If  you  have  a  color  monitor  and  wish  to 
customize  the  colors,  turn  to  Appendix  D  far 
easy  setup  procedures. 
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BASIC  OPERATIONAL  PROCEDURES 

IWS  LOGON  Die  procedure  shown  here  is  far  logging  on  to 

TVJS  after  it  has  been  installed  (Please  refer 
to  the  TWS  INSTALLATION  GUIDE  to  install  TWS) . 
You  log  on  to  TWS  fran  your  DOS  prccpt  by 
typing: 

CD\AREV  {CR>  and,  then:  AREV  {CR>. 

When  the  TWS  Main  Menu  is  on  your  screen,  you 
press  the  {F5>  key. 

This  will  open  a  window  in  which  you  enter: 
ATTACH  TWS  {CR} 

You  will  see  a  message  flash  below  the  window: 
"LISTS  changed  from  volume  REVBOOT  to  volume 
TWS”.  After  the  message  has  flashed,  press 
the  {ESC}  key. 

You  are  now  logged  on  to  TWS. 

GETTING  AROUND 
IN  TWS 

o  Menu  Item  The  menu  selection  system  from  which  you 

Selection  operate  TWS  makes  getting  around  a  fairly 

sinple  procedure.  You  select  a  menu  item  by 
first  highlighting  it  with  the  cursor.  You 
can  move  the  cursor  in  two  ways.  You  can  use 
either  the  Up,  Down,  Right,  and  Left  {ARRCW} 
keys,  or  the  first  letter  of  the  menu  item  you 
want.  The  cursor  will  continue  to  rotate 
through  a  menu,  so  you  can  go  back  and  forth. 
When  a  menu  has  two  or  more  items  with  the 
same  starting  letter,  the  cursor  will  move 
from  one  to  the  next  as  you  continue  to  press 
the  initial  letter. 

When  the  cursor  is  on  the  item  you  want,  press 
{CR>  to  select  it.  If  you  choose  an  item  by 
mistake,  sinply  press  {ESC}  to  return. 

{ESC}  will  always  let  you  escape  back  through 
the  program.  This  will  work  from  individual 
screens,  help  windows,  menus,  and  popups.  Each 
time  you  press  {ESC}  you  move  one  step  back 
towards  where  you  started.  Keep  pressing  it 
until  you  reach  the  desired  location. 


o  The  {ESC}  key 
always  takes 
you  back 


:  Keys  you 
o  press  are 
in  {  }. 

Is  the  car- 
return/ 
key) 


o  Function  Keys 


o  TWS  Help 
Screens 


Use  {FI}  far 
TWS  help 


o  EXIT  Options 
TWS  LOGOFF 


DOS  &  SUSPEND 


Operational  Procedures 


The  function  keys  have  the  same  capabilities 
in  TWS  as  they  do  in  AREV.  The  function 
keyboard  template  provided  by  AREV  will  give 
you  the  appropriate  guidance  for  TWS.  Each 
key  operates  in  both  plain  (e.g. ,  {FI})  and 
control-  xey  (e.g.,  {CF1})  mode. 


Every  TWS  menu  selection  has  a  help  line 
at  the  bottom  of  the  menu.  This  statement 
provides  information  about  that  menu 
selection. 

The  function  key  {FI}  will  show  you  all  the 
help  lines  for  that  menu  in  one  window.  Press 
{ESC}  to  return  to  the  ro'^’u. 

The  function  key  {F2}  will  show  you  menus  that 
are  available  from  the  menu  selection  you're 
on.  This  appears  as  a  window  with  options. 

Use  the  Arrow  keys  to  move  the  cursor  and  {CR} 
to  select.  If  the  window  has  more  than  one 
page,  use  {PgDn}  to  go  from  Page  1  to  Page  2, 
and  {PgUp}  to  go  back  to  Page  1. 

Specific  help  screens  far  TWS  are  provided 
throughout  the  program.  The  primary  help 
access  is  the  {FI}  key.  Using  this  key  will 
give  you  help  information  from  menus,  windows, 
popups,  and  single  record  entry  lines.  Use 
{CF1}  for  the  explanation  of  all  levels  of 
help. 


You  logoff  TWS  from  the  EXIT  option  on  the  TWS 
Main  Menu.  The  LOGOFF  selection  actually 
quits  the  TWS  program,  signing  you  off. 
Choosing  LOGOFF  means  that  you  must  go  through 
the  signing  on  procedure  to  return  to  TWS. 

The  four  options  below  will  return  you  to  TWS. 

Both  the  DOS  and  SUSPEND  options  take  you  to 
DOS  far  processing.  The  difference  is  how 
much  RAM  you  have  available  for  DOS.  The  DOS 
exit  option  does  not  write  AREV  to  the  hard 
disk,  but  the  SUSPEND  option  does.  The  DOS 
option,  then,  is  used  far  minor  processing. 
SUSPEND  is  used  far  major  work. 
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Operational  Procedures 


TCL  &  AREV 


o  Hang  Up  Note 


In  order  to  retun.  to  TWS  fran  either  DOS  ar 
SUSPEND,  type  EXIT. 

Note:  The  SUSPEND  function  creates  a  large 
temporary  file;  it  is  automatically  deleted 
when  you  reenter  TWS  by  typing  EXIT  at  the  DOS 
prompt.  If  you  do  not  reenter  TWS  this  way, 
you  will  get  a  warning  message  the  next  time 
you  try  to  use  SUSPEND.  You  will  need  to  then 
choose  DOS  frcm  the  EXIT  menu,  and  delete 
RDUj.OUT.SUS  manually  at  the  DOS  prompt) 

The  TCL  option  lets  you  use  terminal  level 
language  (The  Command  Language)  far  direct 
entry  of  oarmands.  Choosing  TCL  opens  a 
window  far  you,  and  typing  RESET  will  return 
you  to  TWS. 

Note:  Most  of  your  TCL  work  will  most  likely 
be  from  within  the  TWS  rather  than  as  an  EXIT 
option.  TCL  can  be  easily  accessed  from  TWS 
by  pressing  (F5);  this  feature  is  described 
throughout  the  manual.  Entry  back  to  TWS  is 
achieved  by  pressing  {ESC) . 

The  AREV  option  sends  you  to  the  REVELATION 
Main  Menu  which  will  appear  tiled  on  to  TWS. 
Using  {ESC}  frcm  this  menu  returns  you  to  TWS. 


If  while  running  the  TWS,  the  system  freezes 
up,  a  reboot  is  not  necessary.  If  there  is  a 
message  ending  with  an  exclamation  point  ( ! ) , 
simply  type  END  {CR>;  you  will  be  returned  to 
TWS.  If  there  is  no  I,  press  {A)  to  get  an  i, 
then  type  END. 
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Main  Menu 


SIM1ARY 

o  TWS  Main  Menu 
has  8  Options 


o  Unfolding  the 
Menus 


FUNCTIONS  OF 
THE  MAIN  MENU 
SELECTIONS 


o  SCAN 


o  view 


MAIN  MENU  FEATURES 


There  are  eight  selections  on  the  TWS  Main 
Menu,  each  of  which  leads  to  at  least  one  more 
set  of  selections.  Mary  of  these  selections 
share  the  same  titles;  the  configuration  or 
function  they  lead  to  varies.  You  move  from 
one  menu  to  another  by  the  selection  you  make, 
so  you  don't  see  all  the  choices  at  the  start. 
However,  the  menu  trail,  once  you've  made  a 
choice,  remains  on  the  screen. 

Your  choice  of  a  Main  Menu  item  should  depend 
on  the  function  you  want:  browsing  through 
the  TWS  Library  contents,  working  with  lists 
in  the  Library  taxonomies,  entering  a 
taxonomy,  communicating  files,  or  exiting  the 
TWS. 

Each  of  these  eight  selections  unfold  to 
further  menus.  Most  menu  selections  clearly 
name  their  contents,  and  are  easy  to  remember 
once  you've  worked  with  them. 

A  sunrary  of  the  functions  of  the  Main  Menu 
selections  is  given  below.  The  uses  of  these 
procedures  will  be  demonstrated  in  following 
chapters. 

The  operation  of  scanning  is  to  allow  a  rapid 
look  at  selected  portions  of  the  TWS  Library 
in  list  format.  Selecting  this  option  from 
the  Main  Menu  results  in  a  submenu  containing 
15  selections.  Operation  of  SCAN  and  the 
contents  of  the  submenu  selections  is  covered 
in  the  section  "BROWSING  THROUGH  THE  TWS 
LIBRARY". 

The  VIEW  menu  option  shows  you  the  report 
format  for  each  taxonomy  and  structure  in  the 
TWS  data  base.  View  lets  you  see  the 
information  in  a  structured  format.  For 
exanple,  looking  at  Subtasks  through  the  SCAN 
option  shows  you  the  entries  as  items  in  a 
list,  the  VEEN  Subtask  report  includes  the 
titles  of  each  subtask,  plus  its  related  task 
and  mission,  and  organizational  breakdown. 

See  the  section  "BROWSING  THROUGH  THE  TWS 
LIBRARY"  for  specifics  on  this  function. 
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o  COLLECT 


O  DEVELOP 


o  FILE-PRINT 


o  TRANSLATE 


This  option  is  used  to  assemble  items  fox- 
creating  new  lists  from  existing  TWS  records. 
The  COLLECTOR  lets  you  copy  items  into  a 
separate  file  which  becomes  part  of  a 
Directory.  Operation  of  this  function  is 
covered  in  the  section  "WORKING  WITH  THE  TWS 
LIBRARY  MODULES". 


The  Develop  function  ocrrtains  entry  record 
templates  far  creating  new  taxonomies  in  TWS. 
In  addition  to  developing  task  analyses,  you 
can  algo  use  this  option  to  edit  and  update 
existing  taxonomies.  See  the  chapter 


"ENTERING  NEW 


Vi\A9  MCII3C 


"  far  the  fanner 


function  and  "WORKING  WITH  THE  TWS  LIBRARY 
MODULES"  far  the  latter. 


The  File-Print  option  lets  you  select  records 
from  TWS  far  either  filing  in  a  DOS  file  or 
printing  out.  The  records  will  be  in  the  View 
report  structured  format.  See  "WORKING  WITH 
THE  TWS  LIBRARY  MODULES". 


You  use  this  option  to  EXPORT  and  IMPORT  data 
files.  The  Translate  option  has  a  two-level 
menu,  with  the  Export  selection  first  which 
leads  to  the  Import  menu: 

Export:  Lotus  123,  ASCII,  dBase  III,  Modem, 
Inpart 

Inpart:  Lotus  123,  ASCII,  dBase  III,  Modem 

These  selections  have  templates  for  you  to 
configure  the  files.  You  will  need  to  know, 
or  refer  to  the  specific  application  package 
manual  far  the  proper  configurations  of  these 
files.  Examples  far  working  with  ASCII  are 
provided.  EXPORT  is  discussed  in  the  chapter 
"WORKING  WITH  THE  TWS  LIBRARY  MODULES",  and 
IMPORT  is  detailed  in  "ENTERING  NEW 
TAXONOMIES." 


A  special  feature  has  been  developed  which 
allows  you  to  translate  files  from  TWS  to  the 
PC  modeling  package  MicroSAINr.  Details  are 
provided  in  Appendix  E. 


Main  Menu 


o  ACCESS 


o  EXIT 


The  Access  option  is  a  single  level  menu, 
letting  you  use  external  applications 
programs  without  logging  off  the  TWS.  These 
programs  are  user-supplied,  although  sanple 
routines  are  provided. 

The  Access  menu  lets  you  select  WordPerfect, 
Wordstar,  Supercalc,  dBase,  PROLOG,  and  DOS. 


See  the  applicable  section  in  the  chapter 
"WORKING  WITH  THE  TWS  LIBRARY  MDDULES". 

EXIT  options  are  outlined  in  the  previous 
chapter  "Basic  Operational  Procedures." 
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BROWSING  THROUGH  THE  TWS  LIBRARY 


USE  SCAN  TO 
LOCK  AT  "RAW1' 
LISTS 


Fran  the  TVS  Main  Menu,  choosing  the  SCAN 
option  shows  you  a  15-category  menu.  You  can 
browse  through  any  of  the  taxonomies 
previously  described  in  Table  1  by  selecting 
from  this  SCAN  menu: 


—  Core  Army  Task 
Analysis 

—  Field  Test 
Taxonomy 

—  Blueprint  of 
Battlefield 

—  Conditions 

—  Protective  En¬ 
semble  Task 
Degradation 

—  Failure  Modes 
&  Effects 

—  CMF-MDS 

—  Verb  Functions 


Standard  Task 
Analysis  Para¬ 
meters 

Ability  Taxono¬ 
mies 


Menu  Selection 
Missions,  Tasks,  or  Subtasks 

Tasks  or  subtasks 

Functions 

Conditions 

Generic 


(Levels  defined  in  Table  1;  for  exanple  of 
application,  see  subsection  on  VIEW) 

Synonyms 

Synonyms;  for  exanple  of  application,  see 
subsection  on  VIEW) 

Parameters 


Synonyms;  for  cross  linkage  with  OGRE 
subtasks,  select  Abilities  (because  of  screen 
size  limitations,  only  18  of  the  21  appear, 
but  all  are  accessible  using  the  special 
features  such  as  Terminal  Control  Language 
(TCL) ,  FILE-PRINT,  Depart  and  Inport) 


Cognitive 

Abilities 


Taxonomy 

Cognitive 

Repertories 

Cognitive 

Constructs 

Skills 


Skill 

Clusters 


o  Contents  of 
TWS  Taxono¬ 
mies 


o  Using 

Directories 


o  Making  a 
Directory 
Selection 


Brtvsina — SCAN 


Menu  Selection 

Synonyms;  for  cross  linkage  with  CORE 
subtasks,  select  Repertories 

Synonyms;  for  cross  linkage  with  CORE 
subtasks,  select  Constructs 

Synonyms;  cross  linkage  not  available  in  SCAN 
(but  see  Skill  Clusters,  below,  and  the 
section  on  VIEW  in  this  chapter) 

Synonyms;  far  cross  linkage  with  Field  Test 
taxonomy  subtasks,  select  Skills 


A  guide  to  the  contents  of  the  more  elaborate 
taxonomies  is  presented  in  Appendix  F. 
Selecting  a  few  topics  of  interest  will  give 
you  a  feel  for  menu  operation  and  an  idea  of 
the  nature  of  the  taxonomy  items. 


When  you  make  a  selection  from  the  SCAN  menu, 
you  will  see  a  Directory.  The  Directory 
window  shows  you  the  set  of  lists  that 
currently  exists  far  the  category  you've 
chosen.  Each  directory  has  a  line  between  the 
top  lists  and  the  rest.  List  names  above  the 
line,  like  ALL. MISSIONS,  should  not  be  used 
to  save  special  sets  of  lists  you  wish  to 
build  from  the  supplied  taxonomies  (this 
building  function  is  called  COLLECT  and  is 
described  in  the  section  "WORKING  WTIH  THE  TWS 
LIBRARY  MODULES) .  The  list  mated 
CATDXRY .  COLLECTOR .  LIST  is  meant  to  be  used  as 
a  temporary  holding  location  for  a  given  set 
of  records. 

You  can  choose  to  scan  through  any  list  in  the 
Directory,  above  or  below  the  line. 

When  you  are  at  a  Directory  window,  you  move 
the  cursor  to  the  list  you  want  and  select  it 
with  (CR);  or,  you  can  enter  the  number  of  the 
desired  selection.  Use  the  PgUp  and  PgDn  keys 
to  scan  pages.  If  you  do  not  wish  to  make  a 
selection  from  the  Directory,  press  (ESC) 
twice  to  get  back  to  the  menus. 
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o  ID  Key 


As  you  scan  through  the  CORE  taxonomy 
holdings,  you  will  notice  an  ID  key  code  which 
is  "attached"  to  each  listing.  This  code  is 
explained  in  the  following  exanple. 


Wi'V 


o  Looking  at 
a  GORE  Task 
Analysis  & 
its  ID  Key 


Using  the  CCRE  taxonomy  as  an  exanple,  if  you 
select  MISSIONS  from  the  SCAN  menu,  and  then 
INF. MISSIONS  (Infantry  Missions)  from  the 
Directory,  the  first  listed  item  is  "1*A 
Develop  Plan  Based  an  Mission." 


o  GRGNO  Hie  first  part  of  the  code,  the  number  l, 

refers  to  the  Organization  Number  (ORGNO) .  A 
different  CRGNO  is  assigned  to  a  separate  task 
analysis.  A  listing  of  all  the  ORGNOs 
currently  assigned  to  the  TWS  Library  is  shown 
in  Appendix  G  (you  can  also  get  a  listing  by 
choosing  CRQCHART  from  the  SCAN  menu  and 
selecting  No.  1  from  the  Directory) .  The 
listing  shows  that  CRQJO  l  pertains  to 
infantry  cccmand  and  control  (CNC) ;  note  that 
0RC3K)  2  corresponds  to  infantry  operations. 


o  Mission  The  second  part  of  the  code  is  the  Mission 

&  Tasks  designator  (called  MISSIGNID) ,  in  this  case, 

A.  To  see  the  tasks  which  are  associated  with 
this  mission,  press  {ESC}  to  get  back  to  the 
SCAN  menu,  select  TASKS,  then  selection 
INF. CNC. TASKS  from  the  Directory.  Note  that 
14  tasks  are  associated  with  mission  A.  The 
third  level  of  the  code  thus  associates  a 
given  task  to  a  mission. 


o  Subtasks  To  see  which  subtasks  go  with  each  task  (far  a 

given  mission) ,  select  SUBTASKS  from  the 
SCAN  menu,  then  INF. CNC  from  the  Directory. 

The  fourth  part  of  the  ID  key  refers  to  the 
subtask  identifier. 


o  Seminary 
of  Code 


o  Cross 
Linkage 


The  ID  Key  is: 

CRCTO/MISSICNID/1ASKNO/SUBTASKID 

To  see  the  Infantry  Oonmand  and  Oontrol 
subtasks  classified  by  the  Cognitive  Abilities 
taxonomy,  select  ABILITIES  from  the  SCANNER 
menu,  then  select  INF. CNC  from  the  Directory. 


See  Table  1  in  the  first  chapter  fear  a  sumtary 
description  of  the  Oognitive  Abilities 
taxoneny. 

USE  VIEW  FUR  The  function  of  the  SCAN  feature  is  to  allow  a 

REPORT  FOFMAT  quick,  perused  of  the  TVS  library.  It  is  an 

easy  way  to  see  the  contents  of  taxonomies  in 
list  format.  If  you  are  concentrating  on  a 
given  taxonomy,  however,  you  may  want  more 
information  to  be  available;  the  VIEW  feature 
lets  you  see  the  information  in  a  structured 
format. 

Option  features  give  you  the  choice  of  seeing 
certain  information.  For  example,  in  SCAN 
mode,  Subtasks  are  shewn  as  items  in  a  list. 

In  VIEW,  you  can  request  ORGCHAFT  titles  and 
mission  and  task  descriptions  when  the  option 
far  them  appears  on  the  screen. 

Those  reports  which  consist  of  a  cross  linkage 
of  a  task  analysis  with  the  skills  or 
abilities  taxonomies  are  presented  as  a  two- 
way  matrix  of  data.  The  column  heads  are 
abbreviations  far  the  category.  The  synonyms 
far  these  headings  are  available  with  {F6>  in 
two  ways: 

—  At  the  start  of  a  set  of  reports,  a 
message  flashes  telling  you  about  the 
{F6}  key;  press  it  then  to  get  a  list¬ 
ing.  See  EXanple  VIEW.1 

—  It  is  also  available  in  every  report; 
press  it  during  the  time  the  data  is 
being  written  on  the  screen 

Access  to  the  taxonomies  from  the  VIEW  menu  is 
shewn  in  the  following  chart.  Select  VIEW 
from  the  Main  Menu,  then  proceed  as  indicated 
belcw.  After  making  a  Directory  selection, 
the  {ENTER}  key  moves  you  through  the  list 
(the  Pgl%>  &  PgDn  keys  are  not  functional  in 
the  VIEW  mode) ;  only  forward  scrolling  is 
available. 


o  Using  the 
Selections 


o  You  have 
Structure 
Choioes 


o  Use  {F6}  to 
call  up  info 
Windows 


Care  Army  Task  INVENTORY /Missions,  Tasks,  car  Subtasks 
Analysis 


Field  Test  INVENTORY/Tasks  or  Subtasks 

Taxonomy 

Blueprint  of  STRUCTURE /  Functions 

Battlefield 

Conditions  SIRUCTURE/ Conditions 

Protective  Eh-  AEDTTtCNAL  SCALES/Generic 

seroble  Task 

Degradation 

Failure  Modes  (Levels  defined  in  Table  l;  far  example  of 

&  Effects  application,  see  Example  VTEW.l  below) 

CMF-MDS  STKUCTURE/Synoriyms 

Verb  Functions  SIRUCTURE/ Synonyms  (far  example  of 

application,  see  below) 

Standard  Task  STKDCIURE/Parameters 

Analysis  Para¬ 
meters 

Ability  Taxono¬ 
mies 

Cognitive  STRUCTURE/ Synonyms;  far  cross  linkage  with 

Abilities  CORE  subtasks,  select  ADDITIONAL 

SCALES/Abilities  (because  of  screen 
size  limitations,  only  15  of  the  21  appear, 
but  all  are  accessible  using  the  special 
features  such  as  Terminal  Control  Language 
(TCL) ,  FILE-PRINT,  Export  and  Impart) 

Cognitive  STRUCTURE/ Synonyms;  far  cross  linkage  with 

Repertories  CORE  subtasks,  select  ADDITIONAL 

SCALES /Repertories 

Cognitive  STRUCTURE/ Synonyms;  far  crass  linkage  with 

Constructs  OGRE  subtasks,  select  ADDITIONAL 

SCAIES/Gonstructs 


Skills 


Skill 

Clusters 


o  Comprehensive 
Inventory 
Listing 


o  Missions 


o  Tasks 


o  Subtasks 


o  Comprehensive 
Listing 


Browsing— VIEW 


Menu  Selection 

SIMXTIURE/ Synonyms;  far  cross  linkage  with 
Field  Test  taxonomy  subtasks,  select 
ADDITIONAL  SCALES/ SKILLS,  then  select  front 
the  Directory 

STKXniJRE/Synonyms;  cross  linkage  not 
available  in  VIEW 


In  addition  to  the  screen  listings  generated 
by  the  above  menu  selections,  a  convenient 
ccnprehensive  listing  of  taxonomies  to  the 
Subtask  level  is  available  by  selecting 
INVENTORY  front  the  VIEW  Menu,  then  INVENTORY 
front  the  INVENTORY  Menu. 
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Call  up  the  Infantry  MISSIONS  list  used  in 
Ekanple  SCAN.l  by  selecting  VIEW  front  the  Main 
Menu,  then  INVENTORY,  then  MISSIONS.  Choose 
INFANIRY  .MISSIONS,  and  accept  the  option  of 
GRGCHART  breakdown  by  pressing  {ENTER}.  One 
mission  per  screen  appears.  Note  that  spaces 
show  for  information  front  the  Functions  and 
Conditions  taxonomies  (described  in  Table  1) . 
For  an  example  of  items  added  to  a  mission 
list,  go  back  to  the  Mission  Directory  (press 
{ESC})  and  select  Armored  Cavalry;  information 
from  the  Blueprint  of  the  Battlefield  and 
Battlefield  Conditions  taxonomies  was  added  to 
missions  14  .A  and  14. B. 

Call  up  the  Infantry  Carmand  and  Control  TASK 
list  by  selecting  TASKS  from  the  INVENTORY 
menu,  then  INF. CNC. TASKS.  Accept  both  options 
far  information.  Task  l.A.l  has  attached  to 
it  a  Verb  Function,  Failure  Mode  and 
Criticality  score,  and  Parameter  information 
(details  of  these  taxonomies  are  in  Table  1) . 

Directory  selection  INF.  CNC  from  the  SUBTASK 
menu  will  list  Infantry  Ccrmand  and  Control 
subtasks.  Select  all  three  information 
options. 

For  an  overview,  select  INVENTORY  from  the 
INVENTORY  Menu,  then  INF. CNC 
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Infantry  Command  and  Control  subtasks  matched 
with  cognitive  Abilities  are  accessed  by 
choosing  ADOITTCNAL  SCALES  free  the  VIEW  menu, 
then  ABILITIES,  and  finally  INF.CNC.  Accept 
the  two  options,  and  press  {F6>  when  the 
international  window  announcing  a  pop-up 
feature  flashes.  The  resulting  window  lists 
the  titles  of  the  Ability  abbreviations  (use 
the  PgUp  &  PgDn  keys  to  scroll  through  the 
list) .  See  Table  l  far  mare  information  on 
the  Cognitive  Abilities  taxonomy.  Press  {ESC) 
to  remove  the  pap-up  window  and  finish  screen 
printing  far  the  subtasks  associated  with  the 
first  task.  Then  press  {ENTER}  to  bring  up 
the  next  screen.  The  pop-up  feature  can  be 
invoked  again  by  pressing  {F6}  as  the  material 
is  being  written  to  the  screen. 

Terminal  Control  Language  (TCL)  has  some  very 
powerful  and  easy-to-use  query  features  which 
allow  more  specific  browsing  through  files.  A 
detailed  description  of  TCL  is  provided  in 
Appendix  H. 


USE  TCL  PGR 

SPECIFIC 

LOOK-UPS 


WORKING  WITH  TWS  LIBRARY  MXULES 


LISTS 


o  A  list  is 
really  a 
Collection 
of  Record 
Keys 


o  Listmaking  is 
a  2-Step  Pro¬ 
cess 


BUILD  A  LIST 
FRCM  A  LIBRARY 
TAXCNCMY  WITH 
COLLECT 


List  processing  is  a  central  feature  of  TWS. 
The  TWS  application  software  is  delivered  with 
over  175  lists,  and  you  will  very  quickly 
begin  to  add  your  own  lists  to  this  number. 

The  variety  of  uses  far  list  processing  is 
almost  uni  united:  build  jobs,  duties, 
directories,  dicticnaixes,  indexes,  and 
collections;  divide  large  data  files  into 
smaller  and  mare  manageable  groups  of  items 
that  have  related  attributes. 

This  chapter  describes  how  to  work  with  the 
lists  in  the  TWS  libraries  (the  principles 
apply  directly  to  twxonomies  you  create 
yourself) .  The  next  chapter  shows  how  to 
build  taxonomies  from  scratch. 

Every  record  in  a  TWS  file  has  a  unique  record 
key  (i.e. ,  ID  code).  This  record  key  can  be 
used  to  access  any  part  or  all  of  the  record 
that  it  identifies.  The  software  takes 
advantage  of  this  unique  record  key  in 
constructing  lists.  The  lists  that  are  built, 
stored,  and  processed  are  actually  ordered 
lists  of  record  keys. 

In  all  cases  the  creation  of  a  list  involves 
two  steps: 

—  Assembling  a  collection  of  record  keys, 
and  then 

—  Naming  and  saving  the  collection  as  a 
record  in  the  LISTS  file 

The  Main  Menu  function  you  use  for  this 
process  is  COLLECT,  described  below. 


The  Collector  Key  directories  operate  the  same 
way  the  Scanners  do.  And  you  can  read  through 
the  items  in  a  selected  list  in  the  same  way. 
The  Collector,  however,  lets  you  collect  items 
into  a  new  list. 
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o  Collectors  You  choose  sterns  by  moving  the  cursor  to  those 

will  Order  you  want,  and  pressing  {OR}.  When  you  choose 

the  Items  the  first  item,  the  number  1  appears  in  the 

You  Select  Order  column;  the  second  item  you  choose 

becomes  number  2,  and  so  on.  You  can  remove 
an  item  free  your  choices  by  returning  the 
cursor  to  it  and  pressing  {CR}  again.  When 
you  do  this,  the  Order  column  automatically 
renumbers  the  items. 

o  Saving  a  List  Use  the  SAVE  {F9>  key  to  accept  the  list  when 
after  Items  you  have  chosen  all  the  list  items,  mis 
have  been  procedure  will  call  19  an  EDIT  KEYLIST  window 

Collected  which  shows  the  record  key  labels.  Press  {F9> 

again  to  initiate  the  list-naming  part  of  the 
process. 

o  Caution:  A  You  will  see  the  question  "Save  as  NAME. 

List  will  COLLECTOR.  LIST?  {CR}  *  Yes",  where  NAME  * 

overwrite  Mission,  Task,  etc.  If  you  want  your  list 

the  contents  saved  in  this  scratch  buffer  (selection  number 
of  any  pre-  2  of  the  applicable  Directory) ,  accept  this 
vious  list  list  name  by  pressing  {CR}  and  then  {F9>  to 

with  the  same  save  it. 
name 

You  can  give  your  list  any  name  by  typing  {N} 
for  No  at  the  question.  Then  enter  a  list 
name  using  any  format  which  is  applicable  to 
your  needs. 

o  Location  of  Your  new  list  is  now  added  to  the  appropriate 
New  List  Directory  (e.g. ,  Missions,  Tasks,  or  Subtasks 

Directory) .  If  you  accepted  the  default  name 
it  appears  as  selection  number  2.  If  you  gave 
it  your  cun  name,  this  file  appears  on  the 
Directory  as  the  first  entry  below  the  line. 
Ycur  new  list  can  now  be  called  up  via  SCAN, 
VIEW,  COLLECT,  or  FTTi:-FRH7r. 

BUHD  A  LIST  The  Terminal  Control  Language  (TCL)  feature 

FRCM  A  LIBRARY  was  introduced  in  the  BROWSE  chapter  (see 

TAXONCMY  USING  Appendix  H  for  details) .  If  you  want  to 

TCL  create  a  list  whose  items  have  a  related 

attribute,  the  SELECT  function  will 
automatically  gather  those  items  without  the 
user  having  to  search  through  a  list  to 
collect  them.  Assume  far  example  that  you 
want  to  assemble  a  list  of  Tasks  from  the  CORE 
Taxonomy  which  begin  with  PLAN.  Press  {F5}  to 
invoke  the  TCL  mode,  then  type: 


SSELECT  TASKS  WITH  TASK  'PLAN]  •  {CR} 


(Note:  SSELECT  Sects  &  Selects  the  records  on 
the  ID  key) 

Tl^an  use  the  SAVELIST  cxxnsand  to  name  and  save 
these  records: 

SAVELIST  PLAN. TASK  {CR} 

Note:  You  can  focus  your  queries  on  specific 
lists  (1)  by  pacifying  an  CRGNO  in  the  query 
statement,  or  (2)  by  first  accessing  a  list 
using  the  GETLIST  oamand  (e.g.,  GETLIST 
MISSICNS.OPS)  to  baring  a  list  which  is  on  a 

Directory* 

o  Assign  the  The  newly  created  list  can  be  assigned  to  the 

List  to  a  appropriate  Directory  by  performing  these 

Directory  staple  steps: 

—  From  the  Main  Menu,  select  DEVELOP,  then 
DATA  BASE  STRUCTURE,  then  INDEX  LISTS 

—  Scroll  to  the  appropriate  Index  item  (e.g. , 
Tasks,  Jobs,  Abilities)  and  press  {CR}. 
Cursor  to  the  point  just  above  where  you 
would  like  to  add  the  name,  press  {CR}  to 
create  a  blank  line,  then  type  in  the  list 
name  (e.g.,  FLAN. TASK  far  above  exanple.) 

(Note:  Far  a  list  of  editing  ccnmands, 
press  {FI},  then  {F2}  for  specifics) 

—  Press  {F9}  to  save  the  addition,  then 
{ESC}. 

You  have  now  added  a  list  to  the  TWS  Library. 
Any  time  you  cadi  up  the  Directory,  this  new 
list  will  appear  as  a  selection. 

EDITING  OF  LISTS 

o  Reordering  or  In  further  work  with  your  new  list,  or  in 
Deleting  using  the  TWS  supplied  lists,  you  may  want  to 

Records  reorder  or  drop  same  of  the  records.  Sinply 

call  up  the  file  via  COT  I  JET,  and  create  a  new 
arrangement  per  the  selection  instructions 
in  the  section  above  on  the  use  of  COLLECT. 
Then,  save  the  new  list  under  the  file  name 
which  suits  your  needs  (Remember  the  Caution 
note  above). 
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Deleting  the 
Entire  File 


Using  ENTRY- 
UPDATE  Tem¬ 
plates  to  make 
Changes  to  Items 
in  a  List,  to 
Add  new  Items 
to  a  List,  or 
to  Delete  Items 


Technique  1 


Working  with  Lists — Templates 

You  nay  decide  to  delete  certain  lists.  The 
easiest  way  to  do  this  is  to  call  the  file 
in  the  COLLECT  mode,  and  without  selecting  any 
items,  go  through  the  save  procedures  as 
described  in  the  COLLECT  section  above  (i.e. , 
save  nothing  to  the  file  name  in  question — be 
sure  to  use  the  proper  file  name! ) .  The  list 
no  longer  appears  on  the  Directory. 

Note:  Deleting  unwanted  taxonomies  to  claim 
mare  hard  disk  space  can  be  easily 
accccplished  by  following  the  procedures 
outlined  in  Appendix  B) 

The  following  procedures  are  easy  and  handy  to 
vise  for  minor  editing  to  your  lists.  It  is 
best  to  know  in  advance  the  ID  codes  of  the 
items  you  want  to  edit  (sinply  browse 
through  the  list  in  SCAN,  e.g. ,  &  make  a  note 
of  the  codes  of  those  records  to  be  changed) . 

—  Fran  the  TWS  Main  Menu,  select  DEVELOP 

—  Fran  the  next  menu  choose  from  DATA  BASE 
STRUCTURE,  INVENTORY  ANALYSIS,  or 
ADDITIONAL  SCALES,  depending  on  where  your 
list  is  located  (e.g.,  if  you  are  dealing 
with  Missions,  you  would  select  INVENTORY 
ANALYSIS) 

—  From  the  next  menu,  make  a  selection  based 
on  the  type  of  list  you  have 

—  {F9>  is  used  for  saving  changes  to  records. 
See  also  the  next  section  on  List 
Maintenance. 

At  the  template,  if  you  know  the  ID  record 
keys  for  the  records  you  want  to  change, 
enter  the  ID  far  the  first  record  at  the  top 
prcrpt,  then  work  you  way  through  the 
template.  If  you  want  to  delete  a  record, 
press  {ALT)-{D>  two  times.  Far  new  records, 
sijply  enter  the  appropriate  codes  to  the 
prcnpts.  More  information  on  the  use  of  these 
templates  is  available  in  the  next  chapter  on 
"ENTERING  NEW  TAXONCMIES".  Skip  the  next 
subsection  on  Technique  2  if  you  have  a  list 
of  ID  keys  for  editing. 


Working  with  Lists — Templates 


Technique  2 


Special  Sect- 
tians  of  the 
Template 


—  At  the  template,  press  {CTHL}-{F10} 

—  Select  number  3,  GETLL3T  {CR> 

—  Type  the  name  of  the  list  you  want  to  edit 
and  press  {F9> 

Note:  If  you  are  unsure  of  the  list  name 
and  have  already  pressed  {CIRL}-{F10}  or 
made  selection  number  3,  press  {ESC}  to  get 
a  clear  template,  then  press  {F6}  and  call 
up  the  Scanner  Directory  which  contains  the 
applicable  type  of  lists  from  which  you 
want  to  choose.  Once  you  have  a  list  name 
{ESC}  bade  to  the  clear  template,  and 
proceed  as  above  by  entering  the  code 
information  and  scrolling  to  the 
appropriate  line(s)  of  the  template  (using 
{OR},  arrow  keys,  or  FgUp/PgDn)  to  make 
your  edits. 

{F9>  is  used  to  move  to  the  next  record  of 
the  taxonomy  if  you  do  not  need  to  perform 
ary  edits  to  the  current  record. 

Note  the  use  of  the  {F6}  key  as  an  aid  in 
adding  new  text  or  making  replacements  to  the 
special  sections  of  the  Missions  and  Tasks 
templates,  that  is,  the  Conditions. 

Functions,  and  Parameters  areas.  Although  you 
can  type  in  any  information,  using  these 
actual  taxonomies  via  the  Collector  from  the 
pop-up  menu  at  {F6>  is  easy:  with  the  cursor 
in  the  appropriate  special  section  area,  press 
{F6>.  Select  the  applicable  Collector,  then  a 
list  from  the  next  menu,  then  Collect  the 
items  you  want  by  highlighting  the  areas  and 
pressing  {CR}.  When  done  collecting,  press 
{F9>.  The  items  will  automatically  appear  in 
the  section  of  the  template  in  question  (6 
will  overwrite  ary  information  already  there) . 
r  or  ary  editing  of  information  in  these 
special  section,  press  {F3>  and  make  the 
changes.  Press  {F9>  to  save  your  items  in  the 
special  section. 

(Note:  Any  edits  to  these  collected  lists  of 
Conditions,  Functions,  or  Parameters  while 
using  a  Develop  template  do  not  affect  the 
Master  Lists  from  which  you  obtained  the 
items.  To  make  permanent  Master  List  changes 
to  these  special  taxonomies  you  would  need  to 
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Caution 


Working  with  T.-ists— Templates 

go  to  the  Master  List  itself  (e.g. ,  DEVELOP/ 
DATA  BASE  SIRDCIURE/CCKDITICNS) ,  and  make  the 
edits  using  the  applicable  template) . 

A  special  section  of  the  Subtasks  template  is 
the  Elements  section.  Elements  can  function 
as  the  4th  level  of  a  taxonomy.  Items 
pgr»i~|i*r  to  a  given  subtask  may  be  directly 
entered  and  edited  here.  Common  items  among 
subtasks  can  be  easily  copied  to  other 
subtasks.  You  the  user  enter  the  items;  there 
is  no  separate  taxonomy  as  discussed  above 
which  can  be  collected  into  this  area.  More 
details  on  the  specific  use  of  this  section 
are  provided  in  the  next  chapter  (see 
"Subtasks  Template"  under  the  DEVELOP 
feature) . 

—  When  done  with  a  given  record,  or  if  no 
changes  are  needed  to  that  record,  press 
{F9>  to  move  sequentially  to  the  next 
record 

Note:  The  last  part  of  the  template  is  a 
holding  point  far  any  notes  you  may  want  to 
make  about  a  record.  The  notes  are 
"localized"  to  this  template  and  will  not  show 
up  on  screen  or  paper  printouts. 

—  When  done  editing,  press  {ESC} 

When  you  make  edits  to,  say,  a  Collected  list 
you  may  want  to  leave  the  "Master"  list 
intact.  However,  edits  to  records  in  a 
COLLECTED  list  will  also  be  made  to  those  on 
the  Master  list  having  the  same  record  key 
(with  the  exception  noted  just  above  in 
Special  Sections  of  the  Template) .  A  solution 
to  avoiding  changes  to  the  Master  list  is  to 
create  new  record  keys  (thereby  creating  a 
new  taxonomy)  far  your  COLLECTED  list.  A 
convenient  way  to  do  this  is  to  convert  the 
file  to  ASCII  and  use  your  system  editor  or  a 
word  processing  package  to  make  the  changes, 
then  upload  the  "new"  list  to  TWS.  The 
tradeoff  is  that  other  information  keyed  to  a 
given  record  key  will  no  longer  be  related  to 
the  new  record  keys  (e.g. ,  Tasks  which  go  with 
a  given  Mission)  unless  you  Collect  those 
Tasks  and  give  than  the  new  record  ID  as  vail. 
See  the  section  in  this  chapter  on  Exporting 
TWS  files,  then  the  section  in  the  next 
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o  List 

Maintenance 


Working  with  Maintenance 


chapter  on  using  the  Inpart  function  far 
adding  new  lists  to  the  IMS  library 

Adding  or  deleting  records  to  a  list  requires 
updating  procedures  called  List  Maintenance 
(These  procedures  are  not  necessary  far  sinply 
Collecting  lists  ar  just  making  edit  changes 
to  already  existing  reoards) .  Updating  is 
required  to  relate  record  information  with 
valid  record  keys  (in  fact,  TOS  will  report  a 
record  as  missing  whenever  it  encounters  a  key 
without  a  related  record) .  Maintenance 
involves  a  series  of  SSELECT  and  SAVELIST 
oonmands  (via  TCL)  to  those  lists  which  are 
related  to  the  reoards  in  question. 

EXAMPLE  1.  You  add  new  records  or  delete 
existing  ones  from  a  task  list  of  a  taxonomy 
whose  CK2TO  is  300,  say.  You  would  at  least 
need  to  update  that  task  list.  If  it's  name 
were  TASKS. EXAMPLE,  the  two  statements  would 
be: 


SSELECT  TASKS  WITH  CRGNO  *  300  {CR} 
SAVELIST  TASKS. EXAMPLE  {CR} 

If  you  also  made  additions  or  deletions  to 
subtask  records  within  the  same  taxonomy 
(i.e.,  CRGNO  300),  then 

SSELECT  SUBTASKS  WITH  CRGNO  =  300  {CR} 
SAVELIST  SUBTASKS.  EXAMPLE  {CR} 

EXAMPLE  g.  If  the  above  taxonomy  is  for  a 
given  conpany  and  you  have  similar  lists  for 
different  companies  under  different  GRGNOs, 
you  may  want  to  have  a  glorified  task  list, 
for  exanple,  which  contains  all  tasks  of  all 
cxxtpam.es  in  a  given  region  of  the  country. 
Assume  that  the  companies  in  question  have 
GRGNOs  300,  301,  and  302.  To  update  this 
"master4'  regional  task  list: 

SSELECT  TASKS  WITH  CRGNO  -  300  CR  CRGNO  - 
301  CR  CRGNO  «  302  {CR} 

SAVELIST  TASKS. REGICNA  {CR} 

If  in  addition  you  have  an  overall  task  list 
for  all  regions  of  the  country  (and  the  CRGNOs 
of  the  companies  run  from  300  to  309),  then: 
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SSELECT  TASKS  WITH  CR34D  BETWEEN  300  AND  309 


DOWNLOADING  TWS 
LISTS 


o  Using  the 
FILE  Function 


Caufejop 


Accessing 
the  File 


SAVELI  ST  TASKS.  REdONAIL 

Note:  The  use  of  Terminal  Control  Language 
(TCL)  was  introduced  in  the  BROWSE  chapter. 


You  may  want  to  download  a  TWS  list  to  ASCII 
far  storage  (filing)  or  processing,  or  to  an 
applications  package  such  as  a  ward  processor 
for  specific  work.  TWS  offers  two  main  ways 
to  do  this: 

FTLE-FRENT  of  the  TWS  Main  Menu  will  create 
ASCII  files.  The  version  generated  by  this 
procedure  is  formatted  like  the  version  you 
see  when  you  cedi  up  the  list  from  VIEW 
(i.e. ,  organizational  headers,  etc.  will  be 
included). 

—  Choose  FTT  F.-PRTvr  from  the  Main  Menu 

—  Select  the  type  of  list  from  the  next  menu 

—  Select  the  list  name  from  the  Directory 

—  Select  {F>  from  the  window  query 

—  Specify  the  drive  and  path  location  for 
filing  location;  far  example,  to  save 
TEST. 1ST  within  the  AREV  directory,  you 
would  type: 

C:\AREV\TEST.LST 

TWS  will  overwrite  a  file  with  a  matching  file 
name. 

To  see  the  file  after  the  FILE  procedure  has 
been  performed,  select  ACCESS  from  the  Main 
Menu,  then  DOS.  At  the  DOS  prompt  (you  are  in 
the  AREV  directory  at  this  point) ,  enter 

TYPE  TTST.IST|MDRE 

To  return  to  TWS,  type  EXIT  at  the  DOS  prompt 

In  addition  to  using  this  FILE  feature  for 
archiving,  the  ASCII  file  could  also  be 
accessed  by  another  editor  or  word  processing 


o  Using  the 
EXPORT 
Template 


Step  1:  Create 
a  Data  Buffer 
File 


Step  2:  Create 
a  Data  Diction¬ 
ary  Buffer  File 


Working  with  T.i sta — rranloadinq  with  EXPORT 

package  fear  processing  (the  above  path  would 
be  specified  to  the  package  far  location  of 
the  file) .  Remember,  a  list  downloaded  by  the 
FIIE  function  will  be  in  the  VIEW  format. 


The  TRANSLATE  feature  of  the  Main  Menu  offers 
downloading  functions  of  1WS  files  far  LOTUS 
123,  dBase  HI,  modem  operations,  and  ASCII 
conversion.  The  ASCII  feature  will  be 
demonstrated  here.  Far  information  on  the 
first  two  items,  select  one  from  the  menu,  and 
at  the  template,  press  {FI)  far  specific 
guidance.  Use  of  the  modem  feature  requires 
applications  software  and  a  short  program 
written  to  the  M3DEM.BAT  file  in  the  AKEV 
directory.  Guidance  is  given  in  Appendix  I, 
ACCESSING  EXTERNAL  APPLICATIONS  PROGRAMS. 

A  special  exporting  feature  far  working  with 
the  modeling  package  MicroSAINr  has  been 
developed  and  its  use  is  discussed  in  Appendix 
E. 


—  From  the  Main  Menu,  select  EXIT,  then  AREV, 
then  TOOLS,  then  FILES,  then  MAKE  FILE 

—  Type  BUFFER  at  File  name  prompt 

—  Type  TWS  at  Volume  prenpt 

—  Press  {F9> 

—  A  buffer  file  is  now  attached  to  TWS;  this 
procedure  will  not  have  to  be  performed  far 
future  export  operations 

—  Make  sure  the  data  buffer  is  empty  by 
entering  TCL  {F5>,  typing  CLEAR-FHE 
BUFFER  {CR>,  and  Y  {CR>  at  the  query 

The  proper  data  dictionary  must  be  present  in 
a  buffer  file,  and  the  following  steps  need  to 
be  performed.  If  during  your  present  TWS 
session  you  have  already  entered  the  steps 
below  and  want  to  extort  records  of  a  similar 
type  as  before  (e.g. ,  Missions) ,  skip  this 
step.  If  you  have  set  up  a  dictionary  buffer 
far  one  type,  say  Missions,  but  now  wish  to 
export  sane  of  another,  such  as  Subtasks,  go 
to  TCL  ( {F5»  and  enter:  a£AR-FTLZ 
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Step  3:  Pre¬ 
pare  the  Rec- 
ordccpy  Tem¬ 
plate  far  the 
File  to  be 
Exported 


Working  with  lists— Downloading  with  EXPORT 


DICT. BUFFER,  respond  {Y>  {CR>  to  the  query, 

then  re  setup  the  buffer: 

—  Firm  the  Main  Menu,  select  DOT,  then  AREV, 
TOOLS,  RECORDS,  and  RECORD  Copy 

—  At  Source  file  prcnpt,  type  DICT.  followed 
by  type  of  file  being  used  (select  from  the 
menu  obtained  by  pressing  {F2}) .  For 
example,  if  your  records  involved  Missions, 
the  entry  wuld  be  DICT.MISSICKS 

—  Type  DICT. BUFFER  at  Destination  file  prompt 

—  Eirter  *  at  Source  Record  (s)  prcnpt 

—  Use  down  arrow  to  move  to  Option  (s)  field 

—  Press  {A},  immediately  followed  by  {F9> 

—  Use  the  same  Menu  selections  as  in  Step  2 
(EXIT,  then  AREV,  TOOLS,  RECORDS,  &  RECORD 
COPY) 

—  Information  regarding  the  template  far  this 
part  of  the  EXPORT  procedures  is  available 
by  pressing  {FI} 

—  At  Source  file  prcnpt,  enter  the  type  of 
file  that  contains  the  records  to  download 
(e.g. ,  Missions,  Tasks,  Subtasks}.  The 
choice  must  be  from  the  menu  obtained  by 
pressing  {F2}  while  at  this  template 
location 

—  Type  BUFFER  at  Destination  File  prcnpt 

—  Press  {CTRL}  {F10}  at  Source  record  (s) 
prcnpt 

—  Make  selection  3  (GETLIST) ,  {CR} 

—  Enter  the  list  name  of  the  file  you  want  to 
download 

—  Press  the  down  arrow  to  get  to  the 
Options  (s)  prcnpt 

—  Press  {A},  immediately  followed  by  {F9} 
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Working  with  Lists — Downloading  with  EXPORT 


Return  to  the  TOS  Main  Menu  ({ESC})  and 
select  TRANSLATE,  then  ASCII.  Choices  far 
each  section  of  the  template  are  available 
by  placing  the  cursor  on  a  given  line,  then 
pressing  {F2>;  general  information  on  the 
tenplate  itself  is  available  at  {FI}. 

—  At  the  Process  name  prccpt  of  the  tenplate 
enter  the  type  of  file  name  used  far  the 
Source  file  pronpt  above,  followed  by 
.ASCII  (e.g. ,  MISSIONS. ASCII;  TASKS. ASCII; 
the  choice  most  be  from  the  list  at  F2) 

(Note:  If  you  enter  a  Process  name  far  a 
previously  created  tenplate,  those 
parameters  will  appear;  additionally,  TWS 
supplies  suggested  parameters  far 
Abilities,  Skills,  &  Functions) 

—  For  DOS  file  name,  enter  a  desired  name, 
such  as  MISSION. ASC.  Specify  a  path  if 
desired;  the  default  location  will  be  the 
AREV  directory  (see  {F2}) 

—  Ehter  BUFFER  far  Revelation  file  name 

—  Enter  32  far  Field  delimiter  (signifying  a 
space  betwen  fields;  you  could  enter  a  44 
here  to  get  a  ccrma,  e.g.,  between  fields — 
see  info  at  {F2}) ;  13,10  at  the  Record 
delimiter  pronpt;  and  26  at  the  Ehd-of- 
file  pronpt  (26  gives  a  CTRL  Z) 

—  Scroll  down  to  Field  Name,  and  type  @ID 
{CR}  {OR}  {OR}  followed  by  the  appropriate 
name(s).  For  this  section  of  the  tenplate, 
the  source  for  names  is  front  the 
Dictionary.  Press  {F5>  for  TCL,  and  type 
LOQKDICT  follow!  by  a  filename  such  as 
MISSIONS,  TASKS,  SUBTASKS,  etc.  Press 
{ESC}  to  return  to  the  tenplate.  @3D 
indicates  that  you  want  the  record  key 
downloaded;  if  your  records  pertain  to 
Missions,  and  you  type  Mission  below  the 
@ID  entry,  then  the  mission  descriptions 
(titles)  are  downloaded  as  well.  You 
therefore  control  what  information  is  sent. 
Note  that  if  your  file  involves  a  special 
taxonany  such  as  Abilities,  say,  each 
separate  Ability  represents  a  field,  and 
each  field  you  want  downloaded  must  be 
listed  (e.g.,  Al,  A2,  A3,  ...) 


Step  4:  Pre¬ 
pare  the  EXPORT 
Tenplate 
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—  Press  {F9>  and  {Y>  {CR>  to  query 


DUPLICATING 

uses  wmnN 

TWS 


PRINTING  USTS 

o  Use  the  FTLE- 
PRINT  Feature 
far  Structured 
Reports 


(Note:  If  you  are  exporting  to  a  DOS  file 
name  which  already  exists,  the  program  will 
ask  whether  or  not  you  wish  to  proceed) 

The  ASCII  file  is  now  located  per  the 
specifications  given  to  MDOS  file  name"  of  the 
template.  Options  far  accessing  it  are:  (1) 
selecting  ACCESS  free  the  Main  Menu,  then  DOS. 
(2)  EXIT  from  the  Main  Menu,  then  SUSPEND, 
then  call  up  an  applications  package  to 
process  the  file.  (3)  ACCESS  followed  by  the 
appropriate  package  selection  if  you  have 
previously  set  up  a  .BAT  file  (see  the  section 
below  in  this  chapter  titled  Access  to 
Applications  Packages) .  Note  that  the 
downloaded  file  has  a  space  between  fields  if 
you  entered  the  "32"  parameter  at  the  Field 
a»i  section  of  the  template.  A  "44" 

would  have  inserted  a  comma. 


Using  the  TCL  {F5>  mode,  you  can  duplicate  a 
list  by  copying  it  to  a  new  name.  Assume  you 
have  a  list  with  the  file  name  TEST.UST.A  and 
you  want  to  create  the  same  list  with  the  name 
TEST. LIST. B.  You  can  duplicate  it  by  using 
the  COPY  USIS  command: 

COPY  USTS  TEST.UST.A  TO:  (USTS  TEST.UST.B 

{CR} 

The  newly  created  list  can  be  assigned  to  the 
appropriate  Directory  by  performing  the  steps 
outlined  in  the  earlier  section  in  this 
chapter  on  building  lists  using  TCL. 


The  FILE-PRINT  Main  Menu  feature  also  allows 
you  to  print  files  in  the  report  format  as 
seen  in  VIE W.  Reports  can  be  printed  to  HP 
laser  Jet  II,  Epson  or  IBM  printers,  or 
compatible  clones. 

To  print,  select  the  {P}  option  ((F)  is  for 
filing  lists) 


"Hang-153"  note: 

Whenever  DOS  encounters  a  disk  drive  that  is 
not  ready,  a  printer  that  is  not  turned  on  car 
one  that  runs  out  of  paper,  or  any  number  of 
other  everyday  events,  DOS  prints  out  a 
variety  of  messages,  all  of  which  end  with  the 
phrase:  "Abort,  Retry,  or  Ignore."  Usually 
you  are  forced  to  reboot  your  system  and  start 
over  again;  AREV  has  overcome  this  problem. 

Die  solution  is  to  press  {A}  until  an 
exclamation  point  (!)  appears;  then  type  END, 
followed  by  a  {CR> .  You  will  be  returned  to 
TVS. 

o  Use  TCL.  for  For  some  printing  needs,  you  may  not  want  the 

Unstructured  structured  format  that  PRINT  above  provides. 

Reports  lb  obtain  a  straight  listing  of  records  (i.e. , 

a  format  ocnpatible  with  SCAN) : 

—  Enter  TCL  {F5} 

—  Type  GEHIST  USINAME,  where  LISINAME  is 
the  name  of  the  list  you  want  to  print 

—  Type  LIST  FILENAME  (P) ,  where  FILENAME 
corresponds  to  the  type  of  record  (e.g. , 
Missions,  Tasks,  Subtasks,  etc.) 

The  (P)  option  in  the  statement  above 
causes  the  list  to  be  printed 

The  EXPORT  option  of  the  TRANSLATE  feature  of 
the  Main  Menu  converts  files  to  ASCII.  Using 
a  systems  editor  or  a  word  processing  package 
you  could  then  customize  the  format  and  print 
the  report  under  external  control.  This 
feature  is  covered  in  this  Chapter  under  the 
heading  Using  the  EXPORT  Template.  Note  that 
you  can  download  whichever  fields  you  want 
using  the  tenplate  feature. 


o  Use  the  EXPORT 
Feature  far 
ASCII  Conver¬ 
sion 


ACCESS  TO 

APPLICATIONS 

PACKAGES 


To  access  a  downloaded  file  far  processing 
outside  of  TVS,  you  could  select  EXIT  from  the 
Main  Menu,  then  DOS  to  work  with  your  systems 
editor  for  example.  To  work  with  a  file  via 
word  processing  software,  you  could  select 
either  the  LOGOFF  or  SUSPEND  options  from 
EXIT,  then  call  up  your  package  from  DOS. 
Access  to  applications  packages  can  be  made 
considerably  easier  by  invoking  the  functions 
of  the  ACCESS  feature  of  the  Main  Menu. 

Sinple  programs  can  be  easily  written  to  .BAT 
files  which  then  allow  "one  touch"  access. 
Details  are  provided  in  Appendix  I,  ACCESSING 
EXTERNAL  APPLICATIONS  PROGRAMS. 


OPTIONS  FOR 
INPUT 


OTTERING  NEW  TAXONOMIES 


EXAMPLE 

TAXONOMY 


Procedures  far  making  new  lists  from  existing 
ones  were  described  in  the  chapter  cn  WORKING 
WITH  LISTS:  the  COLLECT  function  and  Terminal 
Control  Language  (TCL)  allow  easy 
construction  of  specialized  lists.  This 
chapter  deals  with  the  creation  of  lists  from 
"scratch".  Lists  can  be  developed  off  line 
(1)  using  the  MS  DOS  system  editor  (EDUN 
command) ,  (2)  using  a  word  processing  package 
and  converting  the  file  to  ASCII  format,  or 
(3)  using  the  DEVELOP  feature  of  the  TWS  Main 
Menu.  ASCII  files  would  be  entered  into  TWS 
via  the  IMPORT  function,  whereas  DEVELOP 
represents  direct  on-line  TWS  building  of  the 
taxonomy. 

Once  a  taxonomy  is  created  and  is  a  formal 
part  of  TWS,  all  the  functions  described  in 
the  BROWSE  and  WORKING  WITH  LISTS  chapters 
are  then  available  far  use 

To  illustrate  the  procedures  far  creating  new 
taxonomies,  a  general  exanple  will  be  used. 

The  layout  is  shown  in  Table  2. 

It  is  inpartant  that  records  created  off  line 
and  imparted  from  ASCII  format,  have  the 
proper  delimiters.  The  (*)  is  the  system  join 
character  that  TWS  uses  to  build  concatenated 
record  keys.  TWS  reads  a  concatenated  record 
key  using  the  following  syntax  (the  concept  of 
the  record  key  was  discussed  in  example  SCAN.l 
of  the  BROWSE  chapter) : 

0RGN3*MISSIGNID*TASKND*SUBTASKID 

CRGNO  must  be  a  number,  MISSIONID  is  set  up  to 
accept  upper-case  letters,  TASKND  to  accept  a 
number,  and  SUBTASKED  to  accept  lower-case 
letters.  If  these  defaults  are  unacceptable 
far  your  needs,  instructions  to  make  changes 
in  the  record  key  formats  are  provided  in 
Appendix  J. 

Note  1:  If  your  taxonomy  is  lengthy,  the 
system  will  accept  double  letters,  such  as  BB 
or  aa. 
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TABLE  2 


Functioned  Layout  of  Departments,  Branches,  and  Sections  far  ACME 
Company  Example  of  Taxonomy  Entry 


A  Product  Development  Department 

1  Planning  Branch 

2  Production 

B  Marketing 

1  Projections 

a  Trend  Projections  Section 
b  Market  Projections 
c  Sales  Projections 

2  Sales 

a  Current  Accounts 
b  New  Accounts 

C  Finance 

1  Billing 

2  Disbursing 
a  Payroll 

b  Accounts  Payable 

3  Budget 

D  Administration 

1  Personnel 

a  Employee  Records 
b  Appraisals 
c  Training 
d  Recruitment 

2  Operations 

E  Data  Processing 

1  Information  Management 
a  Payroll 

b  Employee  Records 
c  Budget 

2  System  Support 
a  Software 

b  Hardware 
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ORGANIZATIONAL 
CHART  SETUP 


o  Organizational 
Breakdown  Shewn 
in  Report  Head¬ 
ers 


o  Step  1: 
create 
Synonyms 


Entering  New  Taxoncmies — ORGCHAKT 

Note  2:  Although  not  required  far  the  sanple 
taxonomy,  if  Elements  are  to  be  associated 
with  Subtasks  (making  the  taxonomy  a  4-level 
affair — Missions/Tasks/Subtasks/Elements) , 
they  can  be  entered  via  the  two  main 
functions  discussed  in  this  Chapter  far 
creating  taxonomies:  the  IMPORT  and  DEVELOP 
features. 

Far  the  sanple  taxonomy  used  here,  the  ORGNO 
will  be  300,  Departments  are  equivalent  to 
Missions,  Branches  to  Tasks,  and  Sections  to 
Subtasks.  Thus,  record  ID  300*E*2*a  refers  to 
the  Software  Support  Section  of  the  System 
Support  Branch  of  the  Data  Processing 
Department  of  the  ACME  Ccnpany. 


There  is  an  organizational  breakdown  at  the 
top  of  every  printed  TWS  task  inventory  and 
task  analysis  report.  This  breakdown 
describes  the  system  that  is  being  analyzed  to 
a  depth  of  four  levels.  Bach  of  these  levels 
contains  both  a  classifying  title  and  the 
system  name  drawn  from  the  class.  This  header 
is  related  to  the  ORGNO  through  cross  indexed 
information  stared  in  the  files  CRGCHART  and 
SYNONYMS.  Par  Exanple,  an  ORGNO  =  1  causes 
the  following  header  to  be  printed: 


MACEM:  OCMBAT  ARMS 

BRANCH:  INFANIRY 

UNIT:  BATTALION 

FUNCTION:  COMMAND  AND  CONTROL 

The  titles  to  the  left  of  the  colons  are 
organizational  classes.  The  titles  on  the 
right  are  the  names  of  the  organizations  being 
analyzed.  The  ORGCHAKT  levels  far  TWS- 
supplied  taxonomies  were  outlined  in  Appendix 
G.  All  of  this  information  is  coded  to  CRCNO, 
through  cross  reference  to  ORGCHAKT  and 
SYNCNYMS. 


The  first  procedure  far  new  taxonomies  is  to 
set  up  the  Synonyms  far  names  and  class 
titles. 
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Entering  New  Taxcncrdes-^gGCHAKT 


—  Fran  the  WS  Main  Mem,  select  DEVELOP, 
DMA  BASE  STRUCTURE,  SYNONYMS 


—  {FI}  provides  a  help  mem  for  this  template 


—  Because  an  QRGCHAKT  consists  of  4  levels, 
this  window  will  be  completed  4  times; 
press  {F9}  after  each  completion.  Hie 

information  which  is  entered  should  be 
anything  relevant  to  the  taxonomy.  Far  the 
sample  taxonomy,  fill  in  the  template  using 
the  following  data  from  each  row: 


Label 

Definition 

Class 

ACME 

ACME  High  Tech,  Inc. 

Company: 

{F9} 

NE 

Northeast 

Region: 

{F9} 

AV 

Audio-Visual  Equipment 

Function: 

{F9} 

YR 

1989 

Year: 

{F9} 

—  After  the  4th  entry  is  saved,  press  {ESC} 
to  return  to  the  Main  Mem 


o  Step  2: 
Create  the 
Data  Base 
Organization 


To  set  up  a  new  data  base,  you  must  select  a 
unique  and  unused  CRGNO.  Hie  organizations 
supplied  with  the  TWS  are  shown  in  Table  3; 
this  ID  information  is  also  available  by 
selecting  SCAN/CRGCHAKr/All.C®GANIZAIICNS  or 
VIBV/SmKTORE/C^GOiARr/ALL.  ORGANIZATIONS . 

Hie  terms  you  defined  using  the  synonym  entry 
chart  above  will  be  related  to  the  0R3K3 
using  the  ORGCHAKT  Entry  program  of  this 
subsection.  In  this  way,  total 
organizational  information  far  each  record  is 
accessible  via  the  CRGNO. 


—  From  the  Main  Mem,  select  DEVELOP,  DA3A 
BASE  STRUCTURE,  and  ORGCHAKT 

—  At  the  ID  praipt  enter  300 

—  Far  the  4  levels,  enter  the  4  TaW»is  from 
above  (because  upper  case  letters  were  used 
for  the  Synonym  template,  use  them  here  as 
well) 

—  Press  {F9} 
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—  At  the  ID  pronpt,  reenter  300.  The  CRGNO 
infarmaticn  attached  to  the  labels  far  this 
ORGNO  now  appears  in  the  "Create 
Organization  Structures"  window 

—  Corrections  to  the  labels.  Definition,  or 
Class  can  be  cade  by  returning  to  the 
Synonym  entry  template  (DEVELOP/DAIA  BASE 
SIEUCIURE/SYNONYMS)  and  altering  the  label 
name  (e.g. ,  ACME) .  Make  changes  by  placing 
the  cursor  on  the  appropriate  line,  then 
proceed  with  you  edits,  pressing  {F9>  when 


These  new  entries  should  be  updated  to  the 
master  Synonym  and  ORGCHART  lists  by  using 
List  Maintenance  procedures: 

—  Enter  TCL  by  pressing  {F5> 

—  Type  SSELEET  SXNCNXMS 

—  Type  SAVELIST  ALL.  SYNONYMS 

—  Type  SSELECT  CRGCHART 

—  Type  SAVELIST  AIL.  ORGANIZATIONS 

Call  up  these  lists  in  either  SCAN  or  VIEW  to 
see  the  updates.  Keeping  the  CRGCHART  list 
updated  is  essential  to  avoiding  the 
duplication  of  ORGNOs. 


OFF  LINE  CREATION  In  addition  to  using  the  *  as  the  join 
&  IMPORTING  character  in  your  record  keys,  off-line 

records  need  a  field  delimiter  (use  the  coma 
(ASCII  44  Dec) ,  end  of  record  characters  {CR} 

6  {IE}  (ASCII  13,10  Dec),  and  aid  of  file 
character  (SUB}  (ASCII  26  Dec).  Thus,  a 
subtask  entry  would  look  as  follows: 

300*B*i*a,  Subtask  title 

Note:  Although  the  exanple  in  Table  6  does 
not  include  Elements  with  the  Subtasks,  if  you 
are  creating  a  taxonomy  which  requires  this 
fourth  level,  the  procedures  outlined  in 
Appendix  K  should  be  followed  far  the 
inparting  of  the  Subtask  list. 


o  Step  3: 
Update  the 
Master  Syn¬ 
onym  &  CRG- 
CHART  Lists 


Although  options  are  available  far  the  field 
delimiter,  the  use  of  the  comma  is  strongly 
advised.  For  the  sanple  taxonomy,  three  lists 
will  need  to  be  created,  one  each  far 
Departments,  Branches,  and  Sections. 

Once  your  taxonomy  is  ready  and  has  been 
converted  to  ASCII,  follow  the  procedures  in 
the  IMPCKITNG  section  below  far  uploading  the 
files  into  the  TWS. 

Inparting  Alert:  Seme  users  have  reported 
unsuccessful  importing  of  lists  which  contain 
subtasks.  Ihe  problem  was  quickly  solved  when 
the  code  far  each  subtask  was  changed  from  a 
lower  case  to  an  upper  case  letter.  From  the 
exanple  on  the  previous  page,  the  change  would 
be:  300*B*1*A, Subtask  title 

Inparting  Just  as  files  can  be  exported  from  TWS  to 

Files  to  lotus  123,  dBase  HI,  and  ASCII,  so  too  can 

the  TWS  they  shipped  from  these  sources  to  the  TWS. 

This  section  will  illustrate  the  procedures 
far  ASCII.  Information  on  the  packages  is 
available  by  choosing  TRANSLATE  from  the  Main 
Menu,  then  IMPORT  and  the  specific  selection, 
followed  by  pressing  {FI}. 

Step  1:  Create  If  you  have  not  already  done  so  far  exporting 
a  Data  Buffer  operations,  perform  the  steps  below  for  the 
File  data  buffer  file: 

—  From  the  Main  Menu,  select  EXIT,  then  AREV, 
then  TOOLS,  then  FILES,  then  MAKE  FILE 

—  Type  BUFFER  at  File  name  prompt 

—  Type  TWS  at  Volume  prompt 

—  Press  {F9} 

—  A  buffer  file  is  new  attached  to  TWS;  this 
procedure  will  not  have  to  be  performed  far 
future  inpart  operations 

Step  2:  Create  The  proper  data  dictionary  must  be  present  in 
a  Data  Diction-*  a  buffer  file,  and  the  following  steps  need  to 
ary  Buffer  File  be  performed.  If  during  a  given  TWS  session 
(i.e.,  before  logging  off)  you  have  already 
entered  the  steps  below  and  want  to  impart 
records  of  a  similar  type  as  before  (e.g.. 
Missions) ,  skip  this  subsection.  If  you  have 

58 


Step.  3: 
Prepare  the 
IMPORT 
Template 


altering  New  Taxonomies — Importing 


set  tp  a  dictionary  buffer  for  one  type,  say 
Missions,  but  now  wish  to  import  sene  of 
another,  such  as  Subtasks,  then  first  go  to 
TCL  ({F5})  and  enter:  CLEAR-FILE 
DICT.  BUFFER,  respond  {Y}  {CR}  to  the  query, 
then  re-setup  the  buffer: 

—  Fran  the  Main  Menu,  select  DOT,  then  AREV, 
TOOLS,  RECORDS,  and  RECORD  Copy 

—  At  Source  file  prompt,  type  DICT.  followed 
by  type  of  file  being  used  (select  from  the 
menu  obtained  by  pressing  {F2}) .  For 
exasple,  if  your  records  involved  Missions, 
the  entry  would  be  DICT.MISSIONS 

—  Type  DICT. BUFFER  at  Destination  file  prompt 

—  Enter  *  at  Source  Record  (s)  prompt 

—  Use  down  arrow  to  move  to  Option(s)  field 

—  Press  {A},  immediately  followed  by  {F9} 

From  the  Main  Menu  select  TRANSLATE,  IMPORT, 
and  ASCII.  The  procedures  for  filling  out  the 
template  are  similar  to  those  listed  in  the 
EXPORT  section  of  the  previous  chapter 
("Prepare  the  Export  Template") .  The  steps 
are  listed  below.  Again  note  that  you  control 
which  fields  are  involved  in  the  translation 

—  Choices  for  each  section  of  the  template 
are  available  by  placing  the  cursor  on  a 
given  line,  then  pressing  {F2};  general 
information  an  the  template  itself  is 
available  at  {FI}. 

—  At  the  Process  name  prompt  of  the  template 
enter  the  type  of  file  name  used  for  the 
Source  file  prompt  above,  followed  by 
.ASCII  (e.g.,  MISSIONS. ASCII;  TASKS. ASCII) 

(Note:  If  you  enter  a  Process  name  for  a 
previously  created  template,  those 
parameters  will  appear;  additionally,  TWS 
supplies  suggested  parameters  far 
Abilities,  Skills,  &  Functions) 


59 


Step  4: 
Completing 
the  Transfer 
with  Reaard- 


Entering  New  Taxonond.es — Irroortina 

—  Par  D3S  file  name,  enter  the  name  under 
which  the  new  taxonomy  is  filed,  far 
exanple,  MISSION.ASC  (give  its  location  if 
it  is  not  stared  within  the  AREV  directory) 

—  Biter  BUFFER  for  Revelation  file  name 

—  Biter  44  far  Field  delimiter  (signifying  a 
oama  betwen  fields) ;  13,10  at  the  Record 
del  miter  prccpt;  and  26  at  the  Brri-of- 
file  prccpt  (far  CTRL  Z  character) 

—  Scroll  down  to  Field  Name,  and  type  §ID 
{CR>  {CR>  {CR>  followed  by  the  appropriate 
name(s) .  Far  this  section  of  the  template, 
the  source  far  names  is  from  the 
Dictionary:  Press  {F5}  far  TCL,  and  type 
IDCKDICT  followed  by  a  filename  such  as 
MISSIONS,  TASKS,  SUBTASKS,  etc.  Press 
{ESC}  to  return  to  the  template.  §ID 
indicates  that  you  want  the  record  key 
uploaded;  if  your  records  pertain  to 
Missions,  and  you  type  Mission  (note  the 
use  of  the  singular  here,  as  shown  in  the 
listing  to  the  IOOKDICT  MISSIONS  oaranand) 
below  the  6ID  entry,  then  the  mission 
descriptions  (titles)  are  uploaded  as  well. 
You  therefore  control  what  information  is 
sent.  Note  that  if  your  file  involves 
Abilities,  say,  each  separate  Ability 
represents  a  field,  and  each  field  you  want 
uploaded  must  be  listed  (e.g. ,  Al,  A 2,  A3, 
...) 

—  Press  {F9}  and  {Y}  {CR}  to  queries 

To  check  far  accuracy  of  the  importing 
operation,  press  {F5>  far  TCL,  and  type 
LIST  BUFFER  name  {CR},  where  name  *  type  of 
file,  e.g.,  MISSION,  TASK,  SUBTASK 

—  Bran  the  Main  Menu  select  EXIT,  AREV, 

TOOLS,  RECORDS,  and  RECORD  COPY. 


—  At  Source  file  prccpt,  type  BUFFER  {CR} 

—  At  Destination  file  enter  the  type  of 
records  (e.g..  Missions)  {CR}.  You  must 
choose  frcm  the  list  given  at  {F2} 

—  Press  {F2}  at  the  Source  records  prccpt 
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Step  5; 
List  on 
tcry 


Entering  New  Taxororues— Irporting 

—  Select  all  the  BUFFER  records  by  pressing 
{CR>  far  each  one  (the  line  will  be 
highlighted) ,  including  the  last  entry 
(i.e. ,  the  cursor  scrolls  back  to  the  top 
line) ,  then  press  {F9> 

—  Press  {CR}  repeatedly,  transferring  record 
keys  to  the  destination  record  (s)  pronpt 

—  When  the  cursor  moves  to  the  Option  (s) 
pronpt,  enter  {A},  inmad lately  followed  by 
{F9} 

Place  The  inported  records  are  in  the  BUFFER.  To 
Direc-  make  and  save  a  list  of  the  records,  perform 

the  following  List  Maintenance  steps  in  TCL: 

SSELECI  BUFFER 

Then  do  a  SAVEXJST  ocnmand  using  either  one 
of  the  Methods  below: 

Method  1: 

—  Type  SAVELCST  ACME. DEPT 

—  Fran  the  Main  Menu,  select  DEVELOP,  then 
DATA  BASE  STRUCTURE,  then  INDEX  LISTS.  Par 
Missions  (Departments) ,  scroll  to  the 
Missions  line  and  press  {CR}.  Place  the 
name  of  the  list,  ACME.  DEPT,  at  the  desired 
spot  below  the  line  (a  blank  line  far 
insertion  can  be  made  by  pressing  {CR}  with 
the  cursor  one  line  above  the  desired 
location;  {CTRL}  {D}  will  delete  the  entry 
the  cursor  is  on) .  Press  {F9}  then  {ESC} 

—  Call  up  the  INDEX  LISTS  menu  again  and 
repeat  far  the  addition  of  ACME.  BRANCH; 
repeat  far  ACME.  SECT 

Method  2: 

—  In  the  "List  Maintenance"  section  above, 
instead  of  saving  the  missions  list  to 
ACME.  DEFT  after  doing  a  SSEUECT,  save  it  to 
MISSICN.OPIirciCR.LIsr  {OR}  (i.e.,  a  list 
already  on  the  Directory) .  Press  {ESC} 

—  From  the  Main  Menu,  select  OPTIJCT,  then 
MISSIONS,  and  finally  MISSION. COLLECTOR . 
LIST 
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—  Collect  all  the  items,  press  {F9>  twice 

—  Press  {N}  to  the  query 

—  Now  enter  ACHE.  DEPT.  Press  {ESC} 


USING  THE  DEVELOP 
FEATURE  OF  THE 
MAIN  MEND 


o  Mission 
Template 


—  Far  Tasks,  after  SSELBCT  BUFFER,  save  the 
list  to  TASK.  COLLECTOR.  LIST,  and  proceed 
as  above.  For  SUBTASKS,  save  the  list  to 
SUBTASK.  CPU  JCTQR.UST 

The  first  method  demonstrates  the  use  of  the 
INDEX  LISTS  feature;  Method  2  illustrates  the 
use  of  the  OOII<ECTCR  function.  Both  these 
techniques  were  introduced  in  the  previous 
chapter. 


Most  of  the  DEVELOP  entry  programs  are 
essentially  farms  to  be  filled  in.  This 
template  approach  to  taxonomy  building  allows 
you  to  get  the  most  out  of  the  TWS.  Each 
entry  line  is  preopted  with  the  cursor;  when 
you  ocnplete  the  entry,  you  press  {CR}  to 
continue  on.  When  you  have  completed  the 
record  farm,  you  use  {F9>  to  save  it. 

Each  Mission/Task/Subtask  record  entry  farm 
preepts  you  at  every  line.  The  help  screens 
are  available  extensively  throughout  the 
program. 

The  Develop  option  unfolds  to  three  task 
analysis  headings  (Data  Base  Structure; 
Inventory  Analysis;  Additional  Scales)  which, 
in  turn,  unfold  another  time.  Most  of  the 
selections  are  the  same  name  as  those  far  Scan 
and  Collect.  Again,  just  as  far  off-line 
created  lists,  three  sets  of  lists  will  need 
to  be  created  using  the  DEVELOP  feature: 
Departments,  Branches,  and  Sections 

—  To  build  the  DEPARTMENT  records,  which  are 
equivalent  in  the  sample  taxonomy  to 
MISSIONS,  one  would  choose  DEVELOP  from  the 
Main  Mem,  then  INVENTORY  ANALYSIS,  and 
finally  MISSIONS 

—  For  each  of  the  5  Departments  in  this 
example,  an  Enter  Template  would  be 
ocnpleted.  Enter  300  {CR}  far  the  0RGN0, 
then  {A}  {CR}  far  Mission  ID.  The 


organizational  information  which  you 
previously  entered  then  appears.  At  the 
Mission  prompt  enter  the  title  of 
Department  A,  that  is.  Product  Development 

—  The  next  2  parts  of  the  template 
(Conditions  &  Function  Expansion)  were 
built  far  linking  information  from  the 
respective  taxonomies  (see  Table  1  far 
details)  with  military  mission  scenarios. 
However,  ary  information  can  be  entered. 

It  will  appear  on  VIEW  screen  print  cuts 
and  paper  print  cuts  generated  by  the  FILE- 
PRINT  feature  of  the  TWS  Main  Menu. 

Entries  are  not  required,  however 

Note:  When  linking  either  the  Conditions 
or  Function  taxonomies  is  applicable,  the 
following  easy  steps  will  invoke  a  powerful 
feature: 

—  When  the  cursor  is  in  either  area, 

press  {F6>  to  call  up  a  Collector  Menu. 
For  Conditions,  for  example,  select 
"Condition  Collector." 

—  Select  "All. Conditions"  or 

"Condition. Classes"  as  appropriate 

—  Select  the  items  you  want  in  the 

desired  order  by  cursor ing  to  each  row 
and  pressing  {GR} 

—  When  done  selecting,  press  {F9}.  The 
selections  then  automatically  appear  in 
the  Conditions  segment  of  the  template 
(Any  information  which  is  currently  in 
that  section  will  be  overwritten) 

—  If  you  wish  to  make  any  additions, 
deletions,  or  changes,  press  <F3)  and 
perform  your  editing.  Then  press  {F9} 
to  save,  followed  by  (ESC)  (This  {F3> 
step  is  required  for  ease  in  editing  of 
info  in  the  special  template  sections) 

—  The  last  part  of  the  template,  "TWS  Note:" 
allows  you  to  make  notes  about  a  given 
Mission  (Department) ;  the  notes  appear  only 
on  this  template  and  not  on  screen  or  hard 
copy  print  outs.  Entries  are  not  required 
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o  Task  Tenplate 


Entering  New 


I  All 


ies — Develop 


—  When  finished  with  a  given  tecplate,  press 
{F9>  to  save  the  information 

—  Enter  data  far  the  next  Department  (B) ,  and 
proceed  as  above 

—  After  the  last  Department  data  have  been 
entered,  press  {ESC},  then  select  TASKS 
from  the  INVENTORY  ANALYSIS  menu 


—  Enter  300  far  CRGNO  {CR},  {A}  {CR}  far 
Mission  ID,  and  1  {CR}  far  Task  No. 

Headers  and  the  Department  title  appear. 
Type  in  the  first  Branch  far  the  Product 
Development  Department,  that  is.  Planning 
{CR} 

Note  on  Synonym  section  of  template:  The 
military  taxonomies  operate  on  a  verb-first 
format  far  Mission,  Task,  and  Subtask  titles. 
Such  a  structure  allows  far  ispartant  kinds  of 
record  analyses.  Par  example,  in  TCL  a  list 
of  all  Mission  records  which  begin  with  the 
ward  Defend  could  be  easily  obtained  by  the 
query  ooranand: 

LIST  TASKS  WITH  TASK  ’DEFEND]  ’ 

(Query  statements  were  first  introduced  in  the 
Browse  chapter) 

Verb-first  format  is  not  a  strict  necessity 
far  taxonomy  development.  But  using  a 
consistent  nomenclature  can  be  handy  far 
record  processing  of  long  lists.  You  can 
define  key  initial  words  by  selecting  the 
DEVELDP/DAXA  BASE  SIRUCIURE/SYNCNYMS  menus, 
and  proceeding  as  before  (see  the  subsection 
on  setting  up  the  organizational  labels  far 
this  exanple  taxonomy) 

If  the  first  word  of  your  Task  title  matches  a 
TWS-supplied  Synonym  Dictionary  entry,  or  if 
you  make  a  Synonym  Dictionary  entry  per  the 
above  paragraph,  the  first  15  letters  of  the 
definition  will  appear  after  you  enter  the 
Task  title.  You  can  change  an  existing 
definition  by  going  to  the  Synonyms  Ehter- 
Edit  window  (accessed  by  the  menus  listed 
immediately  above) .  You  can  change  any  entry 
that  appears  on  the  Synonym  line  of  the  Task 
template  sinply  by  editing  it. 
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o  Subtasks 
Template 


Entering  New  3 


t-AlAULll1 


jes-^pgvejcp 


—  CKET  CM  is  a  required  entry.  This 
critical  Category  entry  can  be  used  to 
reflect  the  importance  of  a  given  entry. 

The  acceptable  range  is  1  to  4.  If  it  is 
of  no  use  far  a  particular  application,  you 
oould  enter  the  same  number  (e.g. ,  1)  each 
time 


—  PARAMETERS  is  intended  far  correlation  of 
that  taxonomy  with  Tasks  (use  the  {F6} 
feature  as  previously  explained.  However, 
it  can  be  used  just  like  the  Conditions  and 
Function  Expansion  segment  of  the  Mission 
template  to  be  applicaticn-specif  ic  to  your 
needs.  Entry  is  not  required 

—  TVS  Note  is  as  discussed  under  Mission 
template 

—  Wien  entry  is  completed  far  a  given  Task, 
press  (F9> 

—  When  all  Tasks  (Branches)  have  been 
entered,  press  {ESC} 

—  Select  SUBTASKS  from  the  INVENTORY  Menu 


—  Enter  300  {CR},  {B}  {31},  1  {CR},  and  {a} 
{CR}  to  set  up  the  first  Section 
(Department  A  is  not  entered  because  no 
sections  are  listed  under  Branches  1  ctr  2 
of  that  Department — see  Table  2) .  Biter  a 
title  (Trend  Projections)  {CR} 

—  The  Element  section  of  the  template  is 
conceptually  like  the  Parameters, 
Conditions,  and  Function  Expansion  sections 
of  the  previous  templates.  Again,  no  entry 
is  required.  Although  there  is  no  Element 
taxonomy  per  se  from  which  you  choose  items 
as  you  oould,  far  example,  with  Parameters, 
this  section  offers  a  powerful  feature 
because  of  the  details  which  can  be  tied  to 
the  Subtask  level.  "Elements"  essentially 
represents  a  4th  level  in  the  taxonomic 
structure  (Missions,  Tasks,  Subtasks, 
Elements) 

Elements  are  entered  and  edited  from  this 
section  of  the  template  ({CIKL}-{F3}  is  not 
required  far  editing  here) .  If  Subtasks 
have  many  Elements  which  are  similar,  they 
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can  easily  be  added  to  other  Subtasks  via 
the  following  procedures: 


—  After  typing  in  Elements  far  one 

Subtask,  put  the  cursor  on  the  1st  line 
of  Element  inf  oration  you  want  to  be 
duplicated 

—  Press  {CIPL}-{B>  to  define  the  start  of 
the  block 

—  Use  the  down  arrow  to  define  the  rest 
of  the  block 

—  Press  {CERL}-{B}  tp  define  the  end  of 
the  block.  Press  {CIPL}-{F3}  to  cut 
the  block.  The  information  remains  in 
its  original  place  but  now  also  resides 
in  a  buffer  memory 

—  Move  the  cursor  to  wherever  you  want 
the  information  to  be  copied,  then 
press  fC3RL>“{F4>  to  paste  the  block. 
Once  copied,  you  can  then  do  any 
necessary  edits  far  that  particular 
Subtask.  The  same  block  can  be  copied 
to  multiple  locations  until  new 
information  is  placed  in  the  buffer 

—  Press  {F9>  after  the  information  for  each 
Subtask  has  bean  entered 

—  Press  {ESC}  when  finished 

o  List  —  Enter  TCL  via  {F5} 

Maintenance 

—  Update  each  of  the  three  list  types 
(Departments,  Tasks,  Subtasks)  by 
performing  a  SSFIJCT  and  SAVELI  ST  ocnmand) : 

SSELBCT  MISSIONS  WITH  CfiGNO  *  300 
SAVELIST  ACME.  DEFT 

SSELBCT  TASKS  WITH  QRGNO  «  300 
SAVELIST  ACME. BRANCH 

SSELBCT  SUBTASKS  WITH  CR3X)  ■  300 
SAVELIST  ACME.  SECT 

Note:  If  the  list  name  in  the  SAVELIST 
statement  already  exists,  the  new  information 
will  overwrite  the  old. 


66 


o  Place  List  Use  either  of  the  2  Methods  described  in  the 

on  Directory  section  of  this  chapter  on  11  Inserting  files  to 
TWS." 

o  BRCWSE  and  W3RK  All  capabilities  discussed  in  previous 

with  the  Lists  chapters  are  now  available  far  this  taxonomy. 

BROWSE  through  the  lists  in  SCAN  ar  VIEW  (if 
the  latter,  note  that  any  information  you  may 
have  added  in  the  special  template  sections 
will  show  on  the  screen) ;  FKTNT  then;  or  EDIT 
them  (add,  delete,  or  change  record 
information) 


o  CROSS-LINKING  A  useful  capability  of  TWS  is  to  cross-link 

information  from  one  taxonomy  with  another. 
This  linkage  was  di.saLS.sed  in  the  earlier 
chapter  "Browsing  through  the  TWS  Library". 

For  example,  cognitive  functions  in  the 
REPERTORIES  taxonomy  are  linked  with  Tasks; 
the  Cognitive  Abilities  taxonomy  is  linked 
with  Subtasks,  as  is  the  Cognitive  Constructs 
taxonomy.  Two  Skills  taxonomies  are  linked 
with  the  Field  Test  Task  Analysis.  Each  item 
of  the  skill  or  ability  taxonomy  is  linked  by 
virtue  of  a  0  or  1  to  indicate  whether  it  is 
needed  to  perform  a  given  Task  or  Subtask 
This  kind  of  information  can  be  linked  to  new 
taxonomies  which  you  create  by  selecting 
DEVEtCP/ADDITTQNAL  SCALES,  followed  by 
ABILITIES,  SKILLS,  or  REPERTORIES  (depending 
on  whether  the  linking  is  at  the  Task  or 
Subtask  level) .  Completing  the  templates  is 
very  easy:  after  filling  in  the  top  row 
information,  enter  a  {1)  {CR}  or  {0}  {OR}  when 
the  cursor  appears  over  each  ability  or  skill 
item  (actually  you  have  the  option  of  using  a 
code  set  of  any  particular  meaning  to  you;  the 
entries  are  not  limited  to  0  or  1,  but  they 
must  be  numbers). 

Press  {F9}  to  save  the  information  when  done 
with  the  template.  Then,  perform  list 
maintenance.  Using  the  example  from  the 
previous  page: 

SSELECT  ABILITIES  WITH  ORGNO  *  300 

SAVELIST  ACMESECT.ABIL 

Place  the  list  on  the  Abilities  directory  per 
previous  instructions. 


BUILDING  CUSTOM 
TAXONOMIES 


o  Step  l: 

Set  up  the 
Synonyms 


Assume  that  linkage  of  skill  car  ability 
information  is  not  relevant  to  the  exanple 
ACME  taxonomy.  Rather,  you  want  to  link  an 
Inventory  Taxonomy  of  major  offioe  equipment 
which  is  assigned  to  each  Branch,  ws 
provides  you  with  the  capability  to  build 
Customized  Taxonomies  using  a  set  of  Generic 
tools.  These  include: 

—  Generic  taxonomy  file 

—  Generic  Bitry-Edit  program 

—  Generic  Scanner 

—  Generic  Collector 

—  TVio  Generic  View  Poparts 

—  TWo  Generic  File-Print  Reports 

The  main  function  of  this  Generic  feature  is 
the  easy  linkage  of  application-specific 
information  from  the  custom-built  taxonomy 
with  another  taxonomy.  Linkage  must  always  be 
to  the  Task  level.  This  function  will  be 
illustrated  here. 

The  Develop  procedures  will  be  shewn  for  the 
Inventory  Taxonomy  in  Table  3.  Note  that  the 
entries  are  the  number  of  pieces  of  equipment 
tied  to  a  given  Branch  area  (versus  a  0  or  1 
for  the  ability  and  skill  taxonomies) . 

—  Select  DEVELOP,  then  DATA  BASE  STRUCTURE, 
then  SYNONYMS.  Fill  out  a  template  far 
each  row  below,  then  press  {F9}  to  save  the 
information  and  receive  a  new  template 


Label 

Definition  cij 

3 00. TAXI 

PC 

300.TAX2 

M-ERAME 

300.TAX3 

TYPWRTT 

300.TAX4 

CCN-TBL 

300.TAX5 

RCD-FEM 

300.TAX6 

CO-CAR 

300.TAX7 

SHP-TLS 

300.TAX8 

LUBE 

300.TAXITTLE 

flQUUMENT  INVENTORY 

tabu:  3 


Inventory  Table  of  Major  Pieces  of  Offioe  Equipment  Assigned  to 
each  Branch  of  the  ACME  Company 


Branch 

PC  M-Frame  lypwrit  Chf-Tbl  Rcd-Frm  Oo-Car  Shp-Tls  T,ihf> 

A  1 

9 

0 

3 

1 

0 

0 

0 

0 

A  2 

0 

0 

1 

0 

0 

0 

1 

0 

B  1 

14 

0 

0 

0 

0 

0 

0 

1 

B  2 

7 

0 

2 

0 

0 

0 

0 

1 

C  1 

0 

1 

8 

0 

15 

0 

0 

0 

C  2 

0 

1 

5 

0 

13 

0 

0 

0 

C  3 

0 

1 

3 

0 

8 

0 

0 

0 

D  1 

3 

0 

2 

0 

5 

0 

0 

0 

D  2 

3 

0 

1 

1 

0 

2 

0 

1 

E  1 

5 

1 

0 

1 

11 

0 

0 

1 

E  2 

5 

1 

0 

0 

9 

0 

0 

1 

Abbreviations : 

PC  = 

personal  computer; 

r  M-Frame 

=  main 

frame  com- 

puter; 

Typwrit 

=  typewriter; 

Cnf-Tbl  = 

conference  table 

;  Rec-Frm  = 

(types  of)  record  farms;  Co-Car  =  company  car;  Shp-Tls  =  (tyoes 
of)  shop  tools;  Libe  =  (specialized)  library. 


ryrt-gT-ing  New  Taxonomies — Custcn 


o  Step  2: 
Update  the 
Synonyms 


o  Step  3: 
Enter  the 
Data 


o  Step  4: 
Lir+  ’ain- 
tenanoe  & 
Directory 
Update 


Notes:  (1)  The  first  part  of  the  label  refers 
to  the  CRGNO  of  the  taxonomy  you  want  to  link 
up;  the  second  part  of  the  lable  oust  be  in 
caps.  (2)  Seven  letters  of  the  Definition  are 
printed  to  the  screen  and  therefore 
abbreviations  are  suggested.  (3)  The  limits 
of  elements  to  the  Generic  taxonomy  is  eight. 
If  your  special  taxonomy  has  less  than  8 
elements,  fill  cut  the  label  part  and  type 
three  dots  {...}  in  the  Definition  line.  The 
•TAXOTliE  is  required. 

—  Press  {F5>  far  TCL 

—  Type  SSETJECT  SHOWMS 

—  Type  SAVELIST  Ali.SXNCNYMS 

—  Press  {ESC} 

—  Select  the  VIEW/SIHUCTURE/SXNOfWMS  menus 

—  Select  ALL.  SYNONYMS 

—  Scroll  to  the  300  section  and  check  your 
entries  (Changes  can  be  made  fcy  going 
through  the  procedures  in  the  above 
subsection) 

—  Press  {ESC}  and  return  to  the  Main  Menu 

—  Select  DEVELOP,  ADDITIONAL  SCALES,  GENERIC 

—  Enter  the  appropriate  codes  for  CRGNO, 
Mission  (Department)  and  Task  (Branch) . 
Type  the  appropriate  number  of  pieces  of 
equipment  far  each  item  of  the  Inventory 
taxonomy  and  press  {CR}  after  each.  Add  a 
TWS  note  if  desired.  Press  {F9}  to  save 
the  information  and  get  a  new  template. 
Press  {ESC}  when  done 

—  Press  {F5} 

—  Type  SSEXJEJCT  GENERIC  WITH  CRGNO  -  300 
(Note:  GENERIC  is  a  constant  in  this 
expression;  300  is  the  appropriate  GRGND 
for  this  example) 

—  Type  SAVELIST  EQUIP.  INV  (use  any  name  you 
want) .  Press  {ESC} 
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o  Call  up  the 
Linked 
Taxonomies 


Entering  New  Taxonomies — Custom 

—  Select  DEVELOP  frcn  the  Main  Menu,  then 
Dm  BASE  STRUCTURE,  then  INDEX  LISTS 

—  Select  Generic,  and  enter  EC2UIP.INV  at  a 
desired  location.  Press  {F9} ,  then  {ESC} 

The  many  ways  to  browse  through  lists  are  now 
available.  Specifically  far  Generic  linkages, 
the  following  menu  selections  are  appropriate: 

VHW/ADDmCNAL  SCAU2S/GENERIC/B3UIP.  INV 

VHW/ADDrnCNAL  SCALES/GENERIC  h/equip.inv 

The  SCAN  feature  is  available  as  well,  as 
is  the  HUNT  function. 
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APPENDIX  A 

DATA  BASE  MANAGEMENT  SYSTEMS 

One  of  the  most  useful  features  of  the  PC  is  its  ability  to 
handle  large  sets  of  similar  data  called  data  bases.  Some 
everyday  exairples  of  data  bases  include  mailing  lists,  personnel 
files,  parts  catalogs,  and  duty  rosters.  The  PC  can  simplify  the 
typing,  indexing,  storage  and  retrieved  of  this  kind  of  informa¬ 
tion,  and  it  can  rapidly  collate  and  sort  the  information  into 
printed  reports.  The  ccnputer  programs  that  are  designed  to  han¬ 
dle  data  bases  are  collectively  called  data  base  management 
systems  (DBMS) .  In  the  world  of  personal  computing,  as 
differentiated  from  minis  and  mainframes,  there  are  three  basic 
types  of  DBMS;  flat-file  data  bases,  relational  data  bases  and 
progranmable  relational  data  bases. 

Flat-File  Data  Bases 

The  flat-file  DBMS  program  is  little  more  than  a  farm  filer  that 
helps  the  user  create  and  fill  out  formatted  farms,  sort  the 
farms  using  one  or  mare  cross  indexed  records,  and  then  print  out 
collections  of  farms  ar  compiled  reports  that  total  the 
information  contained  in  a  selection  of  forms.  These  programs 
are  called  flat-file  managers  because  they  offer  access  to  the 
contents  of  a  single  file.  Flat-file  managers  are  used 
extensively  in  every  day  applications  such  as  appointment 
calendars,  equipment  inventories,  mailing  lists  etc.  Well 
designed  flat  file  managers  are  simple  to  learn,  easy  to  use  and 
they  fill  many  data  base  needs.  Perhaps  the  best  manual  analogies 
to  the  flat-file  manager  are  the  office  roladex  and  library  card 
catalog. 

Relational  Data  Bases 

In  the  parlance  of  PC  users,  any  DBMS  that  can  draw  information 
from  more  than  one  file  at  a  time  is  a  relational  database.  The 
records  in  a  relational  data  base  are  said  to  be  related  when  they 
contain  a  cannon  data  item.  In  relational  data  bases,  the 
information  is  separated  into  several  files  according  to  the 
functional  uses  of  the  file.  For  example,  the  accounting 
information  for  a  parts  store  might  be  separated  into  a  customer 
file,  a  vendor  file,  a  parts  inventory  file,  an  accounts 
receivable  file,  an  accounts  payable  file,  a  general  ledger  file 
and  others  depending  on  the  business.  Using  this  system,  a  clerk 
could  ring  up  a  sale  to  a  customer  by  entering  the  customer's  name 
and  the  part  nater.  The  data  base  would  use  these  two  fields  to 
lock  up  the  related  information  in  the  files.  Using  the  customer 
name,  it  would  search  the  customer  file  and  automatically  print  an 
invoice  header  with  the  customer's  name,  address,  business  phone 
number,  and  account  number.  The  data  base  would  then  look  up  the 
inventory  record  using  the  part  number  and  print  the  part 
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description,  current  price,  and  discount  on  the  invoice.  The  sale 
would  be  added  to  the  customer's  accounts  receivable  file,  the 
transaction  would  be  posted  to  the  general  ledger,  the  inventory 
stock  would  be  decremented  and  if  it  dropped  below  a  preset 
level,  the  system  would  place  an  automatic  order  far  the  predeter¬ 
mined  number  of  parts. 

The  simple  relational  data  base  is  best  used  in  applications  that 
are  composed  of  linked  farms.  In  these  applications  each  type  of 
farm  constitutes  a  data  base  file.  The  farms  should  be  fairly 
uncomplicated  and  the  information  content  of  each  farm  should  be 
prefarmatted,  that  is,  the  record  fields  on  the  farms  should  be  of 
fixed  length  and  set  information  format.  The  best  uses  far  simple 
relational  data  bases  is  in  point  of  sales  business  applications, 
equipment  maintenance  and  repair,  inventory  control  and  similar 
applications. 

Programmable  Relational  Data  Bases 

The  most  flexible  type  of  relational  DBMS  program  available  far 
the  PC  is  called  the  programmable  relational  data  base.  These 
systems  offer  a  wide  variety  of  features.  They  all  have  a  data 
base  programming  language  and  they  may  offer  a  natural  language 
query  system  or  SQL,  and  an  automated  applications  generator. 

When  oonparing  the  DBMS  programs  that  have  all  of  these  features, 
you  will  discover  that  they  vary  primarily  in  speed  of  operation 
and  the  maximum  number  and  size  of  fields,  records,  and  files  that 
a  single  application  may  contain  or  access.  The  advantage  of  a 
programmable  relational  data  base  is  that  it  provides  the 
programming  tools  to  develop  highly  structured  and  customized 
applications  that  meet  all  of  the  foreseeable  needs  of  the  user, 
while  providing  the  user  with  the  capability  to  perform  free  form 
queries  of  the  data  base,  and  generate  new  reports  and 
applications  that  are  found  to  be  useful  after  the  data  base  is 
put  into  use.  This  feature  prevents  the  application  from  becoming 
obsolete  over  time  by  providing  the  user  with  the  capability  to 
continually  develop  the  data  base  to  meet  changing  information 
needs. 

The  programmable  relational  data  base  is  best  used  in  applications 
where  data  flexibility,  free  form  queries,  processing  speed  and 
custom  design  are  the  key  requirements.  These  data  bases  are  best 
suited  to  the  development  of  general  use  systems.  Same  examples 
would  include  a  training  data  base  to  develop  Skill  Qualification 
Tests,  an  Army  Training  and  Evaluation  Program  (ARTEP)  data  base 
and  of  course  the  Taxonomic  Work  Station  far  generalized  human 
factors  task  analysis.  In  all  of  these  cases  the  key  requirement 
is  on  data  input  and  output  flexibility  and  the  capability  to 
adapt  to  new  requirements  over  time.  At  the  time  the  TW5  was 
designed,  there  were  over  40  programmable  relational  data  bases 
available  far  the  PC;  perhaps  the  most  widely  used  application  was 
dBase  III.  Because  of  its  development  history,  dBase  III  is  best 


76 


DBMS 

suited  to  fixed  format  applications.  It  has  a  rigidly  formatted 
and  limited  file  structure  that  is  ideally  suited  to  predefined 
farm  based  systems,  such  as  accounting,  personnel,  and  equipment 
inventory  management  systems.  The  farm  oriented  structural  limits 
placed  on  field,  record  and  file  size  make  dBase  III  an 
inpractical  choice  where  highly  variable  data  structures  are 
desirable.  Advanced  Revelation  was  selected  for  the  development 
of  WS  because  it  is  based  an  the  concept  of  a  dynamic  string,  in 
which  field,  record,  and  file  sizes  do  not  have  to  be  specified 
when  the  data  application  is  designed.  In  operation,  the 
actual  size  of  these  objects  is  determined  by  the  data  they 
contain,  therefor  Advanced  Revelation  is  best  vised  where  field, 
record  and  file  sizes  are  either  unknown  when  the  application  is 
designed  or  when  the  sizes  of  these  objects  is  expected  to  vary 
widely  over  time. 
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APPENDIX  B 


o  Purpose  is  to 
Free  Ip  Hard 
Disk  Space 


o  Step  1: 
Select  & 
Delete 
frcri  iws 


o  Step  2: 
Delete  from 
AREV 


DELETING  TAXONOMIES 


In  the  chapter  cn  Working  with  Lists,  a  farm 
of  deleting  lists  was  shown  using  the  QOiUECT 
function — that  is,  call  up  a  list,  collect  no 
records  to  the  list,  then  save  the  "list" 
under  the  sane  list  name.  This  technique  does 
not  remove  the  records  from  the  hard  disk.  In 
order  to  delete  lists  with  the  intention  of 
freeing  up  hard  disk  space,  the  following 
procedures  should  be  performed: 

—  In  TCL  {F5}  identify  the  lists  set  far 
deletion.  For  example,  you  can  define  a 
specific  list  or  a  set  of  lists  using  the 
SELECT  statement: 

SELECT  TRANSPORTATION.  MISSIONS 
SELECT  MISSIONS  WITH  CROWD  BETWEEN  1  AND  22 

Specific  list  names  are  obtained  from  the 
Directories  accessed  from  SCAN 

—  Each  SELECT  statement  is  followed  by  a 
DELETEREE  (delete  records)  statement: 

DELETEREE  MISSIONS 

(this  statement  would  be  used  for  either  of 
the  two  SELECT  statements  shown  above) 

—  Repeat  the  SELECT  and  DELETEREC  procedures 
for  TASKS  and  SUBIASKS  as  required 

—  Exception:  the  taxonomies  of  skills  and 
abilities  can  be  deleted  in  a  single  step 
by  using  the  CLEARFILE  statement: 

CLEARFHE  ABILITIES 
CLEARFILE  SKILLS 
CLEARFILE  PFPt-wnmTRg 
CLEARFILE  CONSTRUCTS 

—  (ESC)  from  TCL,  and  select  EXIT  from  the 
TWS  Main  Menu,  followed  by  AREV,  TOOLS, 
RECORDS,  and  DELETE  RECORDS 

—  Type  LISTS  in  the  file  name  field,  and 
press  {F9> 


83 


o  Step  3: 
Delete  the 
List  Name 
from  the 
Directory 


Deleting  3 


f  >  LL 


—  Press  {F2>.  At  the  Collector  window, 
select  the  lists  you  want  to  delete  (use 
{CR}) ,  then  press  {F9>.  You  will  return  to 
the  Delete  record  window 

—  Press  {F9>  to  delete  the  lists  you  just 
selected  in  the  Collector  window 

—  Press  {ESC}  when  done 

—  Select  DEVELOP  from  the  TWS  Main  Menu,  then 
DATA  BASE  SIRDOTJRE,  AND  INDEX  LISTS 

—  Make  the  appropriate  selection  of  file 
type,  then  delete  the  list  name(s)  by 
placing  the  cursor  on  it,  and  pressing 
{CTRL}-{D>.  Hiis  procedure  deletes  the 
list  name  from  the  applicable  Directory 
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APPENDIX  C 


PURCHASING  ADVANCED  REVELATION 


TWS  is 
Available 
on  2  Versions 
of  Advanced 
Revelation 


This  widely  available  data  base  management 
system  is  a  product  of  Revelation 
Technologies,  Inc.  Die  Taxcnanic  Workstation 
System  was  initially  designed  and  tested  under 
Version  1.0.  This  Version  has  since  been 
upgraded  and  in  general  is  no  longer  on  the 
ccnmercial  market.  The  TWS  was  therefore 
converted  to  run  on  the  now  available  (as  of 
the  publication  date  of  this  User  Guide) 
Version  1.1.  TWS  software  far  Version  l.o  of 
Advanced  Revelation  will  always  be  available 
far  distribution  to  those  users  who  have  this 
Version. 
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APPENDIX  D 


COLOR  M3NITGR  SET  UP 


o  Procedures 


o  Types  of 
Windows  & 

TWS  Eicaiples 


1.  Select  VIEW  option  from  TWS  Main  Menu 

2.  Fran  VIEW  mem,  select  VIDED  option 

3.  Within  each  of  the  6  types  of  windows,  use 
the  arrow  key  to  move  cursor  to  item 
(border,  title,  background,  etc.) 

4.  Press  {F2>  far  a  list  of  color  selections 

5.  Select  a  number,  or  move  the  cursor  to  the 
desired  color,  and  press  return.  Use  the 
arrow  key  to  move  to  the  next  item 

6.  When  done  making  selections,  press  {F9>  to 
save  the  selections 

7.  Move  to  next  window  (using  the  arrow  key) 
or  press  {ESC}  to  return  to  the  Mem  (if 
you  choose  the  latter  option,  the  colors 
you  just  selected  will  appear  on  the  View 
Mem.  They  will  appear  at  the  Main  Mem 
level  the  next  time  you  log  onto  the  TWS) 

Application — Templates  used  in  TCL,  COLLECT, 
and  DEVEZjOP  modes 

Popup — Directories 

Mem — Main  Mem 


Help — {CFT}  and  {CF2}  help  screens 

Message — Informational  window  to  inform  user 
that  a  pressed  key  is  not  active  in  the 
current  mode 

o  Reference  For  more  details  see  the  Set  Video  section 

of  the  "AREV  Menus  &  Windows  Reference" 
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MicroSAIOT  Utility 


APPENDIX  E 

TWS-MICRD  SAINT  INTERFACE  UTILITY 

Hooker  is  a  data  preprocessor  that  simplifies  the  initial  work 
involved  in  preparing  Micro  Saint  models  from  TWS  data  c  .qputs. 
This  utility  allows  the  user  to  covert  downloaded  TWS  ASCII  files 
to  Micro  SAINT  task  networks.  To  use  Hooker  you  must  be  fully 
conversant  in  the  use  and  application  of  both  Micro  Saint  and  TWS. 
Hooker  operates  at  three  levels  of  functionality  to  speed  up  your 
modelling  activity;  it  autorates  the  initial  task  entry  and 
creates  a  model  with  standard  defaults;  it  allows  you  to  specify 
the  performance  parameters  on  a  task  by  task  basis;  and,  it  lets 
you  hook  up  follow-on  tasks/networks  using  a  graphic  point  and 
shoot  interface  (Note:  All  other  MicroSAINT  variables,  such  as 
Release  Conditions,  Branch  Probability  equations,  and  Transfer 
Function  equations  need  to  be  entered  from  MicroSAINT  itself) . 


At  the  simplest  level.  Hooker  will  input  a 
ccnxna  delimited  TWS  file  and  convert  it  to  a 
non-connected  Micro  Saint  network  in  which 
each  task  is  created  with  the  Micro  Saint 
default  values  for  time  distribution  type, 
mean  time,  standard  deviation,  and  decision 
type. 

Setting  Model  Task  At  the  second  level  of  functionality,  the 
Parameters  user  may  choose  to  modify  the  default  values 

far  these  parameters  either  far  all  tasks  or 
far  each  individual  task. 


Rapid  Task 
Creation 


Hocking  Up  Task  At  the  most  ccrplex  level  of  functionality, 
Networks  the  user  may  choose  the  parameters  for  each 

task  and  connect  each  task  to  its  following 
tasks/networks.  The  connections  are  created 
using  a  graphic  point  and  shoot  interface 
that  allows  you  to  add  and  delete  tasks  to 
the  list  of  follow-on  tasks. 


HOCKER  OPERATION 

Hooker  is  designed  to  interface  TWS  outputs  to  Micro  Saint,  and  in 
this  sense  is  not  a  Micro  SAINT  editor.  Cnee  a  model  is  created 
using  Hooker,  and  you  have  exited  this  utility,  the  Micro  Saint 
DEV  program  can  be  used  to  make  changes  to  the  model  (Hooker  could 
also  be  used;  it  will  create  a  new  file  by  overwriting  the  old  one 
with  the  same  file  ID;  Hooker  creates  a  .BAK  file  whenever  a  file 
is  overwritten) . 


95 


Hooker  is  located  within  the  AREV  subdirectory  along  with  a  file 
named  MISSIONS. EXX.  The  following  information  uses  this  latter 
file  far  its  examples.  You  should  copy  the  files  BXKER.EXE  and 
MISSIONS .  DOC  to  the  \MSAETC\NEawCKKS  subdirectory  far  the  easiest 
use.  Far  example,  at  the  DOS  O  prccpt, 

COPY  \AREV\HOCKER.EXE  C:\MSAIOT\NEIWCKKS 

You  can  build  your  own  lists  in  TWS  using  any  of  the  techniques 
described  in  the  last  two  chapters  of  this  User  Guide,  then 
EXPORT  (download)  the  list  to  the  \MSMNT\NEIWORKS  location  (see 
instructions  on  Exporting  in  the  Working  with  Lists  chapter) . 

1.  Rapid  Task  Creation 

You  may  use  Hooker  simply  to  enter  the  tasks  into  Micro  Saint 
format.  This  is  a  simple  six  step  process  that  can  save  you  a 
great  deal  of  time.  The  larger  your  model  is  the  more  time  you 
will  save. 

Procedure 

1.  At  the  C  prccpt,  go  the  \MSAINr\NE3WORKS 
subdirectory,  type  Hooker  and  press  Enter. 

2.  Type  the  full  file  name  including  extension,  and 
press  Enter,  as  shown  below. 

Input  file  :  MISSIONS.DOC 

3.  If  Hocker  fails  to  find  the  input  file  name,  it 
will  report  the  error  and  return  to  the  DOS  prccpt. 

4.  When  Hocker  finds  the  input  file  name  it  will 
request  the  name  of  the  Micro  Saint  model  that  you 
are  developing.  Enter  the  name,  as  shown  below. 

Input  file  :  MISSIONS.DOC 
Model  Name:  WARGAME 

5.  Hocker  will  read  in  the  file  and  display  the 
interface  screen: 


Input  file  :  MISSICNS.DOC 
Mocki  name  :  WARGAME 


l.a  DEVELOP  FUN  BASED  0 
l.b  INITIATE  INTELLIGENCE 
l.C  PREPARE  AND  ORGANIZE 
l.d  CONDUCT  TROOP  LEADIN 
l.e  SEE  THE  BATTLEFIELD 
l.f  CONTROL  AND  OXRDINA 
l.g  EMPLOY  FIRES  AND  CTH 
l.h  CONCENIRATE/SHIPT  CD 
l.i  MANAGE  COMBAT  SEKVIC 


Scan  F9 
Collect  FIO 

Select/Edit  PgUp/PgDn 
Collect  Next  Heme 
Change  variables  F7 
Save  F5 
Quit  FI 


Mean:  10.0 
Std  Dev:  3.333 
Distrib:  1 
Decision:  2 


Make  global  F6 

Exit  variables  PgUp 

6.  Press  {FI}  to  quit  and  Hooker  will  create  a 
non-oonnected  Micro  Saint  model,  named  NARGAME, 
from  all  of  the  tasks  contained  in  MISSICNS.DOC  and 
their  associated  task  IDs.  All  of  the  tasks  will 
have  the  standard  Micro  Saint  parameter  default 
values.  If  you  want  to  set  specific  parameters, 
instead  of  pressing  FI  at  this  point,  press  {F5>  to 
save  your  work,  then  proceed  to  step  number  2  of 
the  section  below. 


l.a  DEVELOP  PLAN  BASED 


2.  Setting  Model  Task  Parameters 

You  may  change  the  model  task  parameters  either  globally  (i.e. , 
all  tasks  at  once) ,  or  individually.  The  parameters  that  you 
control  from  Hooker  are  shown  in  the  box  in  the  lower  right  hand 
comer  of  the  interface  screen  shown  above.  Mean  Time  and 
Standard  Deviation  are  real  numbers  that  may  vary  between  0  and 
the  maximum  that  your  version  of  Micro  Saint  will  accept.  Use  the 
following  tables  to  select  the  Time  distribution  type  and  Decision 
type  that  you  want. 


ttteroSftp*r 


Value 

Distribution  Type 

1* 

Normal 

2 

Exponential 

3 

Ganna 

4 

Rectangular 

Value 

Decision  Type 

1 

last  Task 

2* 

Single  Choice 

3 

Probabilistic 

4 

Tactical 

5 

Multiple 

♦Default  values 


Bnocedure 


1.  Select  a  file  and  model  name  as  before. 

2.  Select  the  task  whose  parameters  you  wish  to  change 
by  pressing  the  up  and  dcwn  arrow  keys. 

3.  Press  F7  to  change  variables. 

4.  Select  the  variable  that  you  wish  to  change  with 
the  arrow  keys  and  type  the  desired  value,  then 
press  the  enter  key  to  record  the  value. 

5.  When  you  have  finished  changing  parameter  variables 
press  PgUp  to  return  to  task  scanning. 

6.  Select  a  new  task  to  change.  Notice  that  only  the 
task  that  was  positioned  under  the  highlight  was 
changed  in  this  procedure. 

7.  If  you  want  to  change  all  of  the  tasks  to  the  same 
settings,  do  steps  1  through  5  above  for  one  task 
and  then  press  F6  (Hake  Global) . 

8.  Remember,  you  say  save  the  model  at  any  time  by 
pressing  F5.  Press  FI  to  quit  if  you  do  not  wish 
to  use  Hooker  to  select  follow-on  tasks. 
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mictosaini1  ucnirv 


3.  Hookim  Up  Task  Networks 

Micro  Saint  allows  each  task  output  to  be  connected  to  seven 
follow-cn  task  inputs.  Hooker  lets  you  collect  these  follow-on 
tasks  in  a  sinple  manner  that  will  save  you  considerable  time  in 
Micro  Saint  model  development.  Hooker  uses  a  point  and  shoot 
interface  that  eliminates  typing  and  improves  the  accuracy  of  yr 
model  development. 

Procedure 


1.  Open  a  file  and  press  F6  to  set  global  parameter 

variables. 

2.  Hooker  is  in  Scan  mode  as  indicated  by  the 
highlighted  Scan  F9  text  located  at  the  right-side 
top  of  the  interface  screen. 

3.  Pressing  the  arrow  keys  in  the  scan  mode  causes  the 
task  list  to  scroll  in  the  scanner  window.  The 
task  with  the  inverse  highlighting  will  also  be 
shown  in  the  collector  window  at  the  lower  left 
corner  of  the  interface  screen.  Select  a  task  to 
be  connected. 

4.  Press  F10  to  collect  follow-on  tasks. 

5.  Highlight  a  follow-cn  task  with  the  arrow  keys  and 
collect  it  by  pressing  the  enter  key.  You  may 
collect  up  to  seven  tasks  using  this  procedure. 

6.  To  delete  a  task,  press  PgDn.  Highlight  the 
follow-on  task  to  be  deleted  with  the  arrow  keys 
and  press  the  Del  key.  Press  PgUp  to  return  to  the 
collector  window. 

7.  To  collect  follow-on  tasks  for  the  next  task  in 
sequence,  press  Herne,  and  then  proceed  as  in  5  and 
6  above. 

8.  To  oollect  follow-on  tasks  far  any  task  not  in 
sequence,  press  F9  to  scan  and  proceed  as  in  3 
through  5  above. 

9.  Press  FI  to  exit  Hocker  and  create  the  final 
version  of  your  Micro  Saint  network. 

Hocker  creates  a  file  using  your  model  name  as  the  prefix  far  the 
DOS  file  name.  It  attaches  the  suffix  .MX)  to  the  file  so  that 
the  Micro  saint  programs  will  recognize  the  file  as  a  network 
model.  In  the  exairple  case  given  here,  the  file  name  would  be 
changed  to  NAR3AME.M3D  by  Hooker. 
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APPENDIX  F 


INFORMATION  CN  TWS  LIBRARY  MXULES 


Table  F-l 


Contents  and  List  Lengths  of  Selected  TWS  Library  Modules  Accessed 
by  SCAN,  VIEW,  and  COLLECT  from  the  Main  Menu 


CORE  ARC  TASK  ANALYSIS 

Unit 

Missions 

Tasks 

Subtasks 

Combat  Arms 

Infantry 

CMC 

48 

63 

170 

Oper 

195 

857 

Arm  Cav 

CMC 

7 

16 

81 

Gper 

101 

680 

Artillery 

CMC 

33 

13 

85 

Gper 

125 

482 

Canbat  Sprt 
Arms 

Engineer 

CMC 

13 

12 

108 

Oper 

105 

499 

Mil  Pol 

CMC 

5 

49 

181 

Oper 

37 

190 

Oambat  Srvc 
Sprt 

Transpo 

CMC 

7 

23 

86 

Oper 

40 

102 

MIS  CMC 

23 

176 

46 

MTS  Oper 

90 

624 

90 

103 


Table  F-l,  cent. 


Contents  and  List  lengths  of  Selected  TVS  Library  Modules  Accessed 
by  SCAN,  VIEW,  and  COLLECT  frcm  the  Main  Mem 


oaannvE  abilities  and  ooqjitive  repertories  taxonomies 

CROSS  CLASSIFIED  WITH  SUBTASKS  OF  CERE  ARiY  TASK  ANALYSIS 


Unit 

C2 

Operations 

Cognitive  Abilities 

Armored  Cavalry 

81 

680 

Artillery 

85 

482 

Infantry 

170 

857 

Engineers 

108 

499 

Military  Police 

181 

190 

Transportation 

86 

102 

Cognitive  Repertories 

Armored  Cavalry 

16 

101 

Artillery 

13 

125 

Infantry 

63 

195 

Engineers 

12 

105 

Military  Police 

49 

37 

Transportation 

23 

40 

GOOUTIVE  CONSTRUCTS  TAXONOMY  CROSS  CLASSIFIED 
WITH  SUBTASKS  OF  CORE  ARMY  TASK  ANALYSIS 


Catnunicaticn  87 
Oarprehension  74 
Concept  Farnaticn  62 
Creativity  11 
Decision  Making  84 
Attention  to  Detail  104 
Perception  of  Form  73 
Memory  Retrieval  114 
Quantitative  Reasoning  72 
Planning  75 
Problem  Solving  120 
Time  Sharing  82 
Situational  Assessment  120 
Verbal  Reasoning  54 

Conmand  and  Control  46 
Operations  90 
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TOR  Library  ffodules 

Table  F-l,  oont. 

Contents  and  List  Lengths  of  Selected  TVS  Library  Modules  Accessed 
by  SCAN,  VIEW,  and  COLLECT  fran  the  Main  Menu 


FIELD  TEST  TASK  ANALYSIS 


Unit 

Tasks 

Subtasks 

Mechanized 

Infantry 

11 

61 

Armor 

11 

148 

Artillery 

5 

8 

SKILL  CLUSTERS  TAXCNCMY  CROSS  CLASSIFIED  WITH 
SUBTASKS  FHCM  THE  FIELD  TEST  TASK  ANALYSIS 


Mechanized  Infantry 

50 

Armor 

148 

Artillery 

N/A 

Abbreviations:  Arm  Cav  *  Armored  cavalry;  CNC  •  ooranand  and 
control;  Mil  Pol  =  military  police;  MIS  «  subset  of  most  critical 
Missions/Tasks /Subtasks;  N/A  «  not  available;  Oper  »  operations; 
Sprt  *  support;  Srvc  =  service;  TYanspo  =  transportation  Branch 
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APPENDIX  G 

ORGANIZATION  NUMBER 
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APPENDIX  G 
ORGANIZATION  NIMBERS 


Table  G-l 

Organization  Numbers  (C RQIO)  of  Taxonomies  in  the  TVS  Library 


QRGMO 


Levels 
2  3 


CROW 


Levels 
2  3 


OGRE  AE MY  TASK  ANALYSIS 


1 

CA 

INF 

EN 

QIC 

21 

* 

CA 

CAV 

PIT-A 

CNC 

2 

CA 

INF 

BN 

OPS 

22 

* 

CA 

CAV 

FLT-A 

OPS 

3 

* 

CA 

INF 

00 

CNC 

23 

CS 

ENQ* 

EN 

CNC 

4 

* 

CA 

INF 

GO 

OPS 

24 

CS 

ENGR 

EN 

CPS 

5 

* 

CA 

INF 

PLT 

CNC 

25 

* 

CS 

ENGR 

00 

CNC 

6 

* 

CA 

INF 

PUT 

OPS 

26 

* 

CS 

ENGR 

GO 

OPS 

7 

* 

CA 

ARTY 

BURY 

CNC 

27 

* 

CS 

ENGR 

PLT 

CNC 

8 

* 

CA 

ARTY 

BTKY 

OPS 

28 

* 

CS 

ENGR 

PLT 

OPS 

9 

* 

CA 

ARTY 

SECT 

CNC 

29 

* 

CS 

ENGR 

SECT 

CNC 

10 

* 

CA 

ARTY 

SECT 

OPS 

30 

* 

CS 

ENGR 

SECT 

OPS 

11 

CA 

ARTY 

EN 

CNC 

31 

CS 

MP 

EN 

CNC 

12 

CA 

ARTY 

BN 

OPS 

32 

CS 

MP 

BN 

OPS 

13 

CA 

CAV 

SQCN 

CNC 

33 

* 

CS 

MP 

CO 

CNC 

14 

CA 

CAV 

SQDN 

OPS 

34 

* 

CS 

MP 

CO 

OPS 

15 

* 

CA 

CAV 

TANK 

QIC 

35 

* 

CS 

MP 

PLT 

CNC 

16 

* 

CA 

CAV 

TANK 

OPS 

37 

CSS 

TRANS 

CO 

CNC 

17 

* 

CA 

CAV 

TRP 

CNC 

38 

* 

CSS 

TRANS 

BN 

OPS 

18 

* 

CA 

CAV 

TOT 

OPS 

40 

CSS 

TRANS 

CD 

OPS 

19 

* 

CA 

CAV 

FTJT-C 

CNC 

41 

* 

CSS 

TRANS  PLT 

CNC 

20 

* 

CA 

CAV 

PLT-C 

OPS 

42 

* 

CSS 

TRANS  PUT 

OPS 

FIELD  TEST  TASK  ANALYSIS 

101  CFEX  FTKNX  TANK  P2  110  CFEX  FTBENG  BFV  P2 

111  CFEX  ARTY  M109  PLAYER 


PROTECTIVE  ENSEMBLE  TASK  DEGRADATION  TAXONOMY 
200  BKL  APG  DUGWAY  DO-49 


Note.  When  entering  new  taxonomies  into  the  TVS,  use  an  GRGNO 
other  than  those  listed  above. 

Abbreviations:  APG  =  Aberdeen  Proving  Ground,  MD;ARTY  « 
artillery;  BN  *  battalion;  ERL  *  Ballistic  Research  laboratory, 
APG,  MD;  ECRY  ■  battery;  BFV  *  Bradley  Fighting  Vehicle;  CA  * 
combat  arms;  CAV  «  (armored)  cavalry;  CFEX  «  center  far 
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Table  G-l,  ocnt. 

Organization  Numbers  (0R3K>)  of  Taxonomies  in  the  TVS  Library 


Excellence;  cue  «  ooranand  and  control;  OD  «  cccpany;  CS  *  combat 
support;  CSS  *  combat  service  support;  DO-49  *  research  program; 
DUGWAY  *  Dugway  Proving  Ground,  Utah;  ENGR  *  engineer;  FTBENQ  « 
Part  Benning;  PIKNX  *  Part  Knox;  INF  *  infantry;  Ml 09  «  howitzer; 
MP  *  military  polioe;  OPS  *  operations;  P2  «  (research  program  on) 
Physiological  and  Psychological  Effects  of  NBC  and  Extended 
Operations  on  Combined  Arms  Crews;  FIAYIR  «  (test)  player,  or 
field  test  scenario;  PUT  *  platoon;  PLT/A  •  tank  platoon;  PLT/C  « 
cavalry  platoon;  SQCN  «  squadron;  TRANS  *  transportation;  TRP  - 
troop 


These  CRGNOs  do  not  actually  contain  any  lists,  but  an  JBQK>  and 
CfCCHART  far  them  have  been  "reserved"  as  place  holders  far  those 
users  Who  wish  to  develop  such  taxonomies. 
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APPENDIX  H 

TERMINAL  CONTROL  LANGUAGE 
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o  {F5>  calls 
up  the 
Feature 

O  COUNT,  LIST 
&  SORT  Oan- 

mantte 


o  Query  State¬ 
ment  Format 


o  Use  F2  as  a 
Query  Aid 


APPENDIX  H 

TERMINAL  CONTROL  LANGUAGE 


TCL 


To  access  the  TCL  mode,  simply  press  {F5>;  The 
TCL  window  appears  and  is  ready  far  a  query 
oannand. 

The  COUNT  statement  tallies  the  number  of 
records  that  fit  the  conditions  of  the  query; 
LIST  presents  screen  output  of  the  records 
which  equal  the  query  description.  SGRT 
organizes  them  according  to  stated  criteria. 

The  contents  of  a  query  statement  are  (1)  a 
oannand  verb;  (2)  file  type  to  be  searched; 
and  (3)  the  selection  criteria.  Far 
example,  in 

COUNT  MISSIONS  WITH  CK2ID  =  1 

COUNT  is  the  command  verb,  MISSIONS  is  the 
file  type,  and  the  remaining  phrase 
constitutes  the  criteria.  File  types  are  the 
13  selections  from  the  SCAN  menu.  Only 
certain  key  wards  in  the  selection  criteria 
can  be  matched  with  a  given  file  type  (in  the 
above  example,  GRGttO  is  a  key  ward) .  A  number 
of  sample  query  statements  is  shown  in 
Table  H-l.  A  full  listing  of  file  types  and 
key  words  is  provided  in  Table  H-2.  Par  the 
above  example,  a  value  of  12  would  be  returned 
to  the  query,  indicating  that  12  missions 
exist  under  Organization  Number  1. 

TCL  queries  you  make  during  a  given  session 
are  stared  at  the  top  of  a  list  accessed  by 
pressing  {F2>.  A  {CR>  by  the  highlighted 
statement  will  place  it  in  the  TCL  window 
where  it  is  now  available  far  instant 
prooessing  or  editing. 
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Table  H-l 


TCL 


Examples  of  Terminal  Control  Language  (TCL)  Query  Statements 
(Note:  turn  on  CAPS  IOC3C  for  following  TCT.  nrmvyris) 
Statement  Cements 


COUNT  MISSIONS  WITH  CK2*>  =  37 


SORT  MISSIONS  HUH  CRGND  BETWEEN 
37  AND  40 


Space  required  on  either 
side  of  the  *=  sign 

37  &  40  are  included  in 
the  sort 


LIST  MISSIONS  HUH  MISSION  'PERFORM] '  'word  or  phrase]  •  * 

beginning  with;  use 
upper  &  lower  case 
letters  far  an  exact 
match 


SORT  MISSIONS  HUH  MISSION. VERB  MATCHES 
'PERFORM' 

LIST  TASKS  HTIH  VERB  MATCHES  'PRODUCT' 
LIST  TASKS  HTIH  HUH  TASK  '  [PLANNING]  * 

LIST  TASKS  HTIH  TASK  '  [TARGETS. ' 


All  Core  taxonomy  titles 
begin  with  verbs 

See  Verbs,  Table  1 

'  [ward  or  phrase] '  = 
anywhere  in  text 

'  [word  or  phrase  = 
ending  with;  use  period 
in  search  phrase  if 
title  ends  with  one 


LIST  MISSIONS  HTIH  MISSIONED  =  'A' 

LIST  MISSIONS  HUH  ORQK)  =  40  AND  WITH 
MISSION. VERB  'PERFORM]' 

LIST  OONDITIQNS  WITH  CONDITION  '  [Air 
defense] ' 

SORT  FUNCTIONS  WITH  ID  >  1  AND  WITH  ID 

<  1.2 

LIST  PARAMETERS  HTIH  ID  >  -  2  AND  WITH 
ID  <  4 


LIST  PARAMETERS  WITH  PARAMETER  '  [Data] ' 

LIST  SUETASKS  WITH  CRGNO  -  1  AND  WITH 
MISSIONED  MATCHES  'C'  AND  WITH  TASKNO  -  1 


LIST  ABILITIES  WITH  A1  ■  1  AND  WITH  A6  -  0 
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TCL 


Table  H-2 

Oarrterrts  of  Terminal  Control  Language  (TCL)  Query  Statements 


COMMAND  VERBS 


LIST  SORT  COUNT  SELECT  SSELECT 

FILETYFES  AND  KEY  WORDS  FOR  SELECTION  CRITERION 

MISSIONS: 

OROJO  MISSICNID  MISSION  OCNDITICNS 

FUNCTIONS  MISSION.  VERB 

TASKS: 

ORGNO  MISSICNID  TASKNO  TASK  SYNONYM  VERB 
PARAMETERS 

CRGNO  MISSICNID  TASKNO  SUBTASKH)  SUBTASK 
ELEMENTS  SUBTASK.  VERB 

ABIIITIES: 

CRGNO  MISSICNID  TASKNO  SUETASKID 

The  21  Abilities  A1  thru  A21 

REPERTORIES: 

CROW  MISSICNID  TASKNO  SUETASKID 

The  8  Repertories:  NUMF,  VISP,  OCNR,  DIVR,  COVA, 
DIVA,  MEMO,  STIM 

CONSTRUCTS: 

OR O©  MISSICNID  TASKNO  SUBTASKID 

The  14  Constructs:  AID,  FRF,  MRR,  TMS,  CMP,  CNF, 
VRR,  QNN,  PIN,  SEA,  DCM,  CMD,  FRO,  ORE 

SKILLS: 

ORGNO  MISSICNID  TASKNO  SUBTASKID 

The  42  Skills  A1  thru  A42 

GENERIC: 

ORGNO  MISSICNID  TASKNO  SUBTASKID 

CONDITIONS: 

CONDITION 

FUNCTIONS: 

ID 

PARAMETERS: 

PARAMETER  ID 
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TCL 


Table  H-2,  cent. 

Contents  of  Terminal  Control  Language  (TCL)  Query  Statements 


SELECTION  CRITERIA  LA 


(1)  AND 

(2)  OR 
'3)  WITH 

(4)  BY 

(5)  THAT 

(6)  WHICH 

(7)  INCLUDING 

(8)  CONTAINING  (short  form  is  ' 

(9)  BEGINNING  (short  farm  is 

(10)  ENDING  (short  form  is  '[...') 

(11)  WITHOUT 

(12)  EXCLUDING 

(13)  UNLESS 

(14)  EQUAL  (short  form  is  -  ) 

(15)  LESS  THAN  (short  forms  are  IT  and  =) 

(16)  LESS  THAN  OR  EQUAL  TO  (short  form  is  <  =) 

(17)  GREATER  THAN  (short  forms  are  >  and  GT) 

(18)  GREATER  THAN  CR  EQUAL  TO  (short  farm  is  >  =) 

(19)  NOT  EQUAL  (short  farms  are  #  and  o) 

(20)  FRCM  ...  TO  ... 

(21)  BETWEEN  ...  AND  ... 

(22)  MATCHES  '...' 


Reference:  Guide  to  Filtering.  ADVANCED  REVELATION  TECHNICAL 
REFERENCE. 
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ACCESSING  EXTERNAL  APPLICATIONS  PROGRAMS 
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External  Acolications 


APPENDIX  I 


ACCESSING  EXTERNAL  APPLICATIONS  PROGRAMS 


INIRODUCnCN 


Using  external 
Programs  from 
within  TWS 


Many  users  are  familiar  with  the  operation  of 
background  programs  like  SideKick.  These 
programs  are  usually  loaded  when  the  computer 
is  first  started,  and  they  remain  resident  in 
the  background  while  the  user  is  running  other 
software.  Any  time  the  user  wishes,  the 
background  program  may  be  pepped  up,  used  and 
then  exited,  returning  the  user  to  the  program 
that  was  running  when  the  background  program 
was  called.  These  programs  are  called 
"terminate  and  stay  resident"  programs  or 
sinply  TSRs.  Seme  TSRs  are  very  well 
mannered;  that  is,  they  operate  without 
conflicting  with  other  applications. 

The  External  Program  Menu  lets  you  use  TWS  as 
a  well  mannered  terminate  and  stay  resident 
program.  Any  time  you  want  to  use  another 
program  to  process  TWS  data  or  to  perform  sane 
other  external  task,  you  may  select  the 
program  that  you  want  to  run  from  this  menu. 


Example  scenario  For  example,  you  might  want  to  use  TWS  to 

prepare  tables  of  Repertory  demands  and  Task 
listings  as  DOS  file  reports,  then  use  your 
word  processor  to  customize  the  document  to 
match  the  format  of  a  report  that  you  are 
preparing.  In  this  exanple,  you  would  sign 
on  to  TWS  and  COLLECT  the  lists  that  you  want 
to  output.  Next,  you  would  select  the 
File-Print  Menu  and  prepare  the  DOS  file 
reports,  in  the  last  step  you  would  select 
your  word  processor  from  the  External  Program 
Menu  and  format  the  report.  When  you  exit 
your  word  processor,  you  will  automatically 
return  to  TWS.  TWS  takes  up  a  very  small 
amount  of  RAM  when  you  access  another  program 
this  way,  which  means  that  you  may  use  the 
full  capability  of  your  external  programs. 

Very  simple  DOS  batch  file  programs  are 
provided  below  as  examples  far  accessing  the 
external  applications  programs.  You  may  need 
to  change  the  path  directory  to  fit  your  own 
setup.  Shells  are  provided  in  the  AREV 
directory  with  a  .BAT  extension  (e.g. , 
WORDPERF.BAT) .  To  fill  out  a  shell  frem  MS 
DOS,  get  into  the  AREV  directory,  and  use  the 
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Simple  Batch  files 
are  provided  with 
TWS 


External  Acolications 


EDUN  ocrrand  (e.g. ,  EDUN  WCRDPERF.BAT). 
your  DOS  User  Guide  far  editing  details. 


WQRDSTAR.BAT 
echo  off 

rent  change  directory  to  ws 
od\ws 

ran  call  Wordstar. 

WS 

ran  change  bade  to  AREV  directory 
cd\AREV 

ran  {F6>  *  “Z  *  Ctrl  Z  *  EOF  mark 
“Z 


WORDPERF.BAT 


echo  off 

ran  change  directory  to  wp 
od\wp 

ran  call  vrardperfect. 

WP 

ran  change  back  to  AREV  directory 
cd\AREV 

ran  'Z  =  Ctrl  Z  =  BDF  nark 
~Z 


SUPRCAIC.BAT 


echo  off 

ran  change  directory  to  scale 
od\scalc 

rem  invoke  SuperCalc  software 
SC 

ran  change  back  to  AREV  directory 
od\AREV 

rem  ‘Z  «  Ctrl  Z  *  EOF  mark 
*Z 

DBASEIII.BAT 
echo  off 

ran  change  to  dBASE  program  directory 
od\DB 

ran  invoke  dBASE  software 
DB 

ran  change  back  to  AREV  directory 
od\AREV 

ran  *Z  *  Ctrl  Z  -  BDF  mark  ~Z 
‘Z 


See 
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FRDLOG.BAT 


echo  off 

ran  change  to  AI  directory 
od\AI 

ran  invoke  FRDIDG  software 
AP 

ran  change  back  to  AREV  directory 
od\AREV 

ran  ~Z  =  Ctrl  Z  *  EOF  nark  ~Z 
~Z 

MDDEM.BAT 
echo  off 

ran  change  to  modon  directory 
cd\modem 

ran  invoke  pcplus  software 
pcplus 

ran  change  back  to  AREV  directory 
cd\AREV 

ran  “Z  *  Ctrl  Z  =  IDF  mark  ‘Z 
‘Z 
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CHANGING  TEMPLATES  TO  ACCEPT  DIFFERENT  TYPES  OF  ID  CODES 


o  ID  Entry  The  Develop  templates  are  set  up  to  check  the 

Checks  type  of  input  to  aid  you  in  correct  entry. 

GRGNO  rust  also  be  numeric.  Mission  is 
configured  to  accept  a  letter  ( automatical ly 
changed  to  upper  case  if  not  so  entered) . 

Task  accepts  a  number,  and  subtask  accepts  a 
lower  case  letter.  If  your  needs  dictate 
number  codes  far  mission  and  subtask,  the 
following  procedures  need  to  be  performed. 

o  Changing  the  —  Firm  the  TVS  Mean  Menu,  choose  EXIT,  then 
Validation  AREV,  then  DESIGN,  and  finally  WINDOW, 

codes 

—  If  you  need  to  change  just  Missions  to 
accept  number  codes,  do  steps  1  through  6; 
if  you  need  to  change  subtasks  to  aooept 
numbers  do  step  7 

Step  1:  At  the  window  name  pronpt,  enter 
MISSION.  ENTRY 

Step  2:  At  the  template,  move  the  cursor 
to  any  part  of  the  pronpt  MISSION  ID  and 
press  {F6> .  At  the  menu,  select  Pronpt 
Window,  {CR} 

Step  3:  Move  the  cursor  down  to  the  "In 
pattern"  line  which  contains  QA,  press 
{F4>,  then  {CR} .  Type  ON,  then  press 
{CR}  until  the  cursor  appears  on  the  "Out 
pattern"  line 

Step  4:  Press  {F9},  followed  by  {CR}  {CR} 
{CR}.  Then  press  {F9}  again 

Step  5:  {ESC}  brings  you  back  to  the 
menus.  Select  WINDOW  again  from  the  menu, 
then  type  in  TASK.ENIRY.  Proceed  as  in 
Steps  2  through  4 

Step  6;  {ESC}  to  the  menus,  and  select 
WINDOW  again,  then  type  SUETASK.  ENTRY. 
Proceed  as  in  Steps  2  through  4 
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Step  7;  If  you  are  not  changing  the 
subtask  code  acceptor ,  press  {ESC} .  If  you 
are,  move  the  cursor  to  any  position  in  the 
pi  ciipt  SUBTASK_3D  (note  that  you  are  still 
in  SUBTASK.ENIRY) ,  and  press  {F6} ,  then 
select  Prompt  Window  {CR>.  Proceed  as  in 
steps  3  through  4,  then  {ESC}  back  to  the 
TWS  Menus 


Step  8:  If  you  need  to  allow  Missions  to 
accept  numbers  in  the  Custom  (Generic) 
taxonomy,  select  WINDOW  from  the  Main  Menu, 
then  type  GENERIC.  ENIEtf.  Proceed  as 
indicated  in  Steps  2  through  4.  {ESC}  to 
the  menus 


o  Templates  will 
now  accept 
both  kinds  of 
input 


The  applicable  template  is  now  set  up  to 
accept  any  kind  of  input  and  is  therefore 
generalized  for  any  taxonomies  you  want  to 
create  later  which  do  require  a  letter  for 
Missions. 
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IMPORTING  SUHTASKS  WHICH  CONTAIN  ELEMENTS 

Most  taxoncmic  needs  are  adequately  handled  by 
three  levels — in  the  case  of  the  TWS, 

Missions,  Tasks,  and  Subtasks  (or  far  the 
example  in  Table  2,  Departments,  Branches,  and 
Sections).  If  a  fourth  level  is  required,  the 
Elements  feature  nay  be  used.  Elements 
associated  with  a  given  Subtask  can  be  entered 
directly  into  the  special  section  of  the 
Subtask  DEVEUDP  template  (see  the  last  chapter 
of  this  User  Guide).  The  Subtask  list  could 
also  be  created  off  line  from  the  TWS.  This 
appendix  outlines  the  procedures  far  off  line 
preparation  of  elements  and  imparting  of  the 
file  using  the  ASCII  feature  of  the  TRANSLATE 
function. 

Requirements  An  editor  or  ward  processing  package  which 

allows  the  entry  of  the  ASCII  253  character  (a 
superscripted  2)  and  which  allows  string  input 
of  longer  than  255  characters  without  entering 
a  carriage  return  or  linefeed.  If  you  have 
such  capability,  proceed  to  Technique  1.  If 
your  editor  or  package  does  not  have  this 
capability  and  you  have  not  created  the  list 
yet,  go  to  Technique  2;  if  your  Subtask  list 
containing  elements  has  already  been  prepared, 
go  to  Step  2  of  Technique  2. 

o  Technique  1 

Step  1  Create  your  Subtask-with-Elements  list  off 

line  using  your  editor  or  word  processing 
package  as  follows:  far  each  Subtask,  type 

—  the  ID  key 

—  a  nfMM 

—  the  Subtask  title 

—  a  comma 

—  the  number  of  the  element  (period  or  other 
symbol  after  it  if  desired) 

—  the  Element  title 

—  the  ASCII  253  character  (typically  entered 
by  pressing  {AIT},  typing  253  from  the 
keypad  section  of  the  keyboard,  then 
releasing  the  ALT  key) 

—  repeat  for  next  Element  number  and  title, 
ASCII  character,  etc. 
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TWo  Ways  to 
Ehter  Elements 


Importing  Elements 


Step  2 


o  Technique  2 
Step  1 


Step  2 


—  Press  {Return}  when  all  Element  inf  anna ticr> 
far  that  Subtask  has  been  entered  (i.e. , 
carriage  return,  line  feed  oodes  are 
required  between  subtasks) 


? 


ale  from  Table  2:  Assure  that  in  building 
the  taxonomy  far  the  ACME  Company  example,  you 
want  to  add  Elements  to  the  Employee  Records 
section  of  the  Personnel  Branch  of  the 
Administration  Department 


300*D*l*a, Employee  Records,  1)  Technical 
Personnel! 2)  Admin  Personnels)  Support  staff 

A  !  is  used  here  to  represent  the  super-* 
scripted  2  (ASCII  253  character) ;  the  TWS 
vail  use  it  as  the  disjoiner  character  to 
separate  the  Elements  under  each  Subtask.  You 
would  press  return  in  the  above  example  after 
typing  "Staff". 


Save  the  Subtask  file  as  an  ASCII  file,  and 
IMPORT  it  to  the  TWS  following  the  procedures 
outlined  in  the  chapter  filtering  New 
Taxonomies.  The  only  change  required  on  the 
Subtask  Import  template  is  to  add  ELEMENTS  to 
the  "Field  Name"  section  at  the  bottom  (i.e, 
add  ELEMENTS  after  @ID  and  SUBTASK) .  When  you 
finish  the  Import  procedures  and  call  up  the 
Subtask  list  from  the  appropriate  Directories 
(e.g. ,  from  VIEW  or  DEVELOP) ,  the  Elements 
will  be  listed  in  row  format  under  each 
Subtask. 


create  the  Subtask  list  off  line  as  you 
normally  would;  follow  the  format  procedures 
in  Step  1  of  Technique  1  (except  your  entries 
will  not  include  the  ASCII  253  character  at 
this  time) .  Place  the  list  in  ASCII  format 
within  the  AKEV  Directory. 

—  From  TCL  in  TWS  (i.e.,  press  {F5})  type 

EDIT  DOS  filename 

—  Scrool  to  the  end  of  each  element  and 
insert  the  ASCII  253  character  (press 
{AIT},  type  253  from  the  keypad  section  of 
the  keyboard,  and  release  ALT) .  Make  sure 
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you  have  carriage  return,  line  feed  codes 
at  the  end  of  each  subtask  (if  not  they 
can  be  inserted  by  typing  13  and  10  instead 
of  253),  and  an  end-of-file  character  (26) 
after  the  last  subtask.  If  your  editor  or 
word  processing  package  nade  a  carriage 
return,  line  feed  during  your  data  entry 
(scmetimes  called  a  "soft  return")  you  can 
easily  delete  than  while  in  the  Edit  mode 
by  scrolling  to  the  location  and  pressing 
your  {Del}  key.  If  you  want  to  see  what 
these  characters  lock  like,  just  move  to  a 
blank  line  and  press  AU  followed  by  13 
(release  AIT) ,  then  AIT  10  (release  AIT) . 

When  finished,  press  {F9}  to  save  the  file. 

Go  to  Step  2  of  Technique  1 
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SUBJECT  INDEX 


ACCESS  feature,  27,  50,  App  I 
Advanced  Revelation  (AREV)  1, 
13,  15,  App  C 

Blueprint  of  the  Battlefield, 

4,  29,  33,  34,  41,  61,  App  H 
BROWSE  function,  29-35 
Career  Mangeroent  Fields 
taxonomy,  6,  29,  33 
Cognitive  Abilities  taxonomy, 
8-9,  29,  33,  App  F,  H 
Cognitive  Constructs  taxonomy, 
10,  30,  33,  App  F 
Cognitive  Repertories  taxonomy, 
9,  30,  33,  App  F 
COLLECT  function,  26,  37-38 
Color  monitor  setup,  App  D 
Conditions  taxonomy,  5,  29,  33, 
34,  41,  61,  App  H 
Copying  lists — see  Explicating 
lists 

CORE  Any  Task  Taxoncny,  3,  29, 
31,  33-35,  App  F,  H 
Critical  category  (see  Failure 
Modes  and  Effects  taxoncny 
Cross  linkage  of  taxonomies, 
31-32,  35,  65-69 
Custom  taxonomies,  66-69 
Data  base  management  systems, 
App  A 
Deleting 

Files  (taxonomies) ,  40,  App  B 
Records,  39-40 
DEVELOP  feature,  26,  60-65 
DOS,  22 

Duplicating  lists,  48 
Editing,  39-43 
Elements,  42  ,  63-64,  App  K 
Entering  new  taxonomies,  51-69 
Exit  options,  22-23 
EXPORT  feature,  26,  44-48 
Failure  Modes  and  Effects 
taxoncny  (Critical  Category) , 
6,  29,  33,  34,  63 
Field  Test  Task  Analysis,  4, 

29,  33,  App  F,  H 
FILE  feature,  26,  44 
Generic  feature  (see  Custom) 
Hardware  requirements,  13-15 
Help,  22 


ID  key — see  Record  key 
IMPORTing  feature,  26,  55- 
60,  App  K 

Installation  of  TWS  software, 
19-20 

Library  taxonomies,  3-11,  29- 

30,  33-34,  App  F 
Lists,  37 

List  Maintenance,  43-44,  59- 
60,  64,  68-69 
Log  off,  22 
Log  on,  21 

Main  Menu  (TWS) ,  25-27 
MicraSAINr  interface  utility, 
App  E 

Military  Occupation 

Specialities ,  6,  29,  33 
Movement  in  TWS,  21,  30 
Organization  Number  (GRGNO) , 

31,  51-53,  App  G 
Parameters  taxoncny,  8,  33, 

34  ,  41,  63,  App  G 
Printing,  26,  48-49 
Protective  Ensemble  Task 
Degradation  taxoncny,  5,  29, 
33,  App  G 

Query  statements — see  Terminal 
Control  Language 
Record  key  (ID  key) ,  31,  51, 

55 

Relational  data  base,  App  A 
SCAN  function,  25,  29-32 
Skill  Clusters  taxoncny,  11, 
30,  34,  App  F,  G 
Software  requirements,  15 
SUSPEND  feature,  22 
Synonyms,  53-55,  62,  66,  68 
Templates 
Develop,  60-64 
Edit,  40-44 

Validation  codes,  App  J 
Terminal  Control  Language 
(7CL) ,  23,  38-39,  49,  App  H 
Translate 
Expert,  45-48 
Inpart,  55-60 

Verb  Functions  taxoncny,  7, 

29,  33,  34,  App  H 
VIEW  function,  25,  32-35 
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TWS  Desk  Aid: 

Menu  Outline: 

Summary  of  Frequently  Used  Selections 
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iss  classifiable  with  Subtask  records.  See  also  Table 


APPENDIX  N 

TWS  QUICK  REFERENCE  GUIDE 


141 


/ 


* 


143 


Summary  of  TWS  Functions 
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